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CHAPTER ONE 


INTRODUCTION 


THE PICTURE SYSTEM is a stand-alone, general purpose, 
interactive computer graphics system which can display 
smoothly moving pictures of two- or three-dimensional 
objects. This system has all the capabilities which have 
been found to be needed and wanted by users of computer 
graphics systems. It has been designed as a problem-solving 
tool, a hardware/software system which satisfies real needs 
and can be used to solve practical problems. 


Evans & Sutherland line drawing systems traditionally have 
been applied to applications where perspective and dynamic 
motion, like rotation and zooming, are required. THE 
PICTURE SYSTEM has the same digital hardware capabilities as 
the previous systems, but in addition, has digital picture 
buffering for refreshing the display. The built-in Refresh 
Buffer memory allows more lines and characters in a picture 


and eases the time and data storage: burden on the computer © 
- Which controls THE PICTURE SYSTEM. ae 


picture processing ate’ 

~The basic ‘components of the 
; hard ware_ “procesing . units for. 
‘St as) “rotation, | “zooming | cand 
perspective; an ~ --8192- point © Reftesh | ‘Buffer; a “Picture 


~ Generator; .a_ ‘Character. Generator; a 21" Picture ‘Display; “a 


Tablet to: facilitate picture interaction; and the software - 
to support the systen. 


CHAPTER TWO 


OVERVIEW OF INTERACTIVE COMPUTER GRAPHICS 


Computec graphics is a relatively new and important 
branch of computer technology in which computers prepare 
and present pictorial output. Interactive computer 
graphics goes one step further in that it allows a user 
to dictate changes to the picture and see the results 
immediately. If a system's time lag is more than a few 
seconds, it does not gualify as interactive; in some 
systems, however, the time lag is a very small fraction 
of a second, in which case the user gets the feeling that 
he is actually manipulating the picture itself. 


Computer graphics is a very broad subject and even an 

overview of it can diverge into a great many topics. The - 
purpose of this chapter is to present in general terms 
the concepts necessary for understanding and using THE 
PICTURE SYSTEM. Consequently, it devotes little 
discussion to some aspects of graphics which may be Of. 
interest and importance to some readers but which are no: 


2 prerequisites, to. moder ar snct ag: the rest of | this manual, oo 


“study | sok graphics: can oo -braken douw: inte. tone ee 


“tople: “areas: cr eeon iy a prepared picture, representing ._ 


structures o . be. depicted, preparing a picture of such > 


- structures ana ‘interacting withthe picture, Each ‘co 


these ‘areas is explored: in the following sections. 


1Principles of Interactive Computer Graphics, Newman and Sproull, 
McGraw-Hill, 1973 is a recommended reference covering most 
aspects of computer graphics. 


PICTURE PRESENTATION 


Computer users are familiar with output media such as — 


listings and magnetic tape, where computed results are 
recorded in numerical form. Often the numerical form is 
an artifial way of presenting pictorial data. Computer 
qraphics offers a new output medium on which data can be 
presented visually. 


Graphical Output Media 


At one end of the graphics spectrum lie plotters, where a 
computer-driven pen creates a picture on ae stroke~by- 
Stroke basis. Plotters are unmatched for resolution (a 
measure of the density of individually distinguishable 
output values), but are extremely slow compared to other 
graphic output devices. 


Next there are ‘raster printers, where the computer ~ 


' selectively fills elements of a rectangular mesh with: 
ink. The pattern of filled and empty. elements can be >. 
assembled ‘by the eye into ‘a ‘picture when viewed from ao 
reasonable distance. . Raster printers have rather Goanse 


resclution’ but are much” faster Baer plotters. 


Output. on paper is. permanent, ‘hich’ can be an advantage. 


or disadvantage. To meet the. -need...for an impermanent 
qraphic output medium, » the. Cathode ray cube (CRT) is 
used. Information is presented on a CRT by directing a 
beam of electrons about on its phosphor » coated face. One 
form of CRT, called the storage tube, ‘retains pictures 
semi-permanently by "capturing" the. electrons in tiny 
cells on its face so that those cells glow until the 
electrons are "freed" by an erase pulse. The other form 
is the refresh CRT, whose face emits light for an instant 
when it is struck by the electron beam and then turns 
picture to retain the image which is referred to as 
refreshing. 


Like paper, the refresh CRT can be filled with a matrix 
of dots or can be drawn upon with a set of strokes at any 
position and any angle. An example of the former is the 
home television; an example of the latter is THE PICTURE 
SYSTEM's Picture Display. 


Refresh Rate 


Since the phosphor on the refresh CRT fades almost 
immediately after it is struck by the electron beam, the 
picture must be continually redrawn to be viewed. This 
crate at which it is redrawn is called the refresh rate 
usually measured in frames per second. If the picture is 


not redrawn frequently enough, the eye will notice it 
fading between refreshes, producing an unsightly effect 
known as flicker. The flicker threshold varies somewhat 
from phosrfhor to phosphor and from observer to observer, 
but most observers of the common phosphor, P4, begin to. 
see flicker at a retresh rate of about 30 times per 
second. That is, pictures redrawn more than 30 times per 
second appear flicker free; pictures drawn less than 30 
times per second do flicker; and pictures drawn exactly 
30 times per second are marginal. 


2.1.3 Line Generation 


A line is specified by two end-points (x,y) and (x*y'),. 
expressed in the coordinate system of the CRT, called 
screen coordinates. The actual movement of the electron: 
beam between the two points is accomplished by a hardware 
device called a line generator or a vector generator. A 
sophosticated line generator is also capable of drawing 
lines with a program-specified intensity, or even varying © 
the intensity of a line from one end to the other. In. | 
this most general .case, where line endpoints ‘are... 
specified by. the three coordinates (X,¥sZ), the intensity... 
or brightness of lines can-appear to trail off in the. 
distance. producing aa illusion’ of.: sah ae This techni 
is known as depth-cueing. Sat tre SS 


Line generators can often be made to “araw lines in’ ‘any “of. 
a’ choice of modes such as solid, dashed,. blinking, dashed. , 
.-and.-blinking, etc. Line ‘generators which cah service. 
more than cne CRT are ‘equipped with a. facility for scope _. 
selection. A display program -may select one or more 
scopes and then any subsequent lines drawn appear on all . 
the selected scopes. 


22.1.4 Update Rate 


The advantage of the refresh CRT is that it can show 
smoothly changing pictures. Lines drawn on a CRT do not 
Ceally move, of course, but the illusion of motion is 
imparted by continually redrawing the picture with lines 
at slightly different positions each time, or each frame. 
The eye blends this sequence of slightly different frames 
together into a smoothly moving picture such as a motion 
picture. The rate at which these different frames can be 
displayed is called the update rate. In contrast to the 
refresh rate which counts the number of pictures drawn 
per second, whether or not they are changed, the update 
rate counts only those frames that are different. 


264.5 Picture Buffering 


be split .into™ 


In THE PICTURE SYSTEM a refresh buffer provides storage 
so that the refresh and update rates may be different. 
Although refresh of 30-40 frames per second is required 
to avoid flicker, update of 10-20 frames per. second is 
adeguate to provide smooth motion. In effect, each new 
frame is shown two, three, or even four times while the 
next frame is being computed. 


Data resident in a refresh butfer is called a display 
file. Full frames stored in this buffer may be read out 
and used to refresh the CRT any number of times before a 
new frame is created. Typically, new frames are created 
20 times a second and the picture is refreshed 40 times a 
second; i.e., each frame is shown twice. Thus, the 
presence cf a refresh buffer allows both refresh and 
update to proceed at their respective optimal rates and 
the systen nes a larger line capacity than it otherwise 
would. 


A potential | “problea:” ‘atea exists when a picture is ~ 
refreshed. froma. ‘memory... which’ is Simultaneously -being 
filled: with. a es 


another: This cor 
unsightly. vat 


-buffers and date anc 
‘refresh can be” “euitched: petveen. ‘the two in Ce: way which 
avoids — conflicts. - “Phis: -is called. double-buffering, q 
its only. disadvantage -is that. the amount of pictorial » 
data which may, be buffered. is. halved, In some cases this ° 
can place an. _ unnecessarily low ‘ceiling on the line. 
capacity. .The alternative, | single-buffering, can be used» 
to take advantage of the entire ‘buffering space when the | 
effects are not too disturbing, usually when the pictures _ 
shown are not highly dynamic. In systems without a 
refresh buffer the update and refresh rates must be the .. 
same. This limits -the amount of data that can be 
displayed and the complexity of the picture that can be 
Processed. 


PICTURE DEFINITION 


Data ultimately deposited in a refresh buffer must 
originate in the memory of the computer controlling the 
systen. This computer-resident data is called a data 
base and may be vastly different in form from the display 
file which emanates from it. 


' Data bases may be highly structured, requiring a complex 


program to weave through them, or they may be very 
straightforward. The data base contains the coordinates 
of ¢cints in the structure to be displayed, along. with 
instructions for interpreting those points. Along with 
coordinate information there may be pointers, 
substructure names, and other non-graphic speornation and 
attributes. 


Points are the kLasic geometric entities in the data base.. 
There are three basic instructions for treating a point: 
move the beam to that point, draw a line to that point, 


cr draw a dot at that point. Graphics systems are often. 


designed to understand codes .for several of the most. 


common sequences of the os Te ce (such as;. © 
“move,draw,move,draw,..."), ‘that large tables of»). 
points can be processed ‘based me a single pre-specified. ~~ 


code. 


The most straightforward way to. specify the. nositicn: of a: 


point is simply to state’ its absolute coordinates. An. 


alternative. that often introduces considerable. 
efficiencies, called relative ‘coordinates, entails 


stating the displacement required to get to a point from” 
the previous point. Codes for common: sequences like ~ 


“absolute, relative, absolute, relative..." can be made 
recognizable to facilitate handling tables of points. 


If a structure to be displayed lies ina plane, it is 
simplest and most efficient to define it using two- 
dimensional data. In this case it is typical to supply 
an "x" and a "y" coordinate for each point in the 
structure, and then perhaps a single "z" coordinate which 
applies to all the points. 


If however, the structure is non-planar, it must be 
defined as three-dimensional data where a coordinate 
triple of the form (x,y,z) is given for each point. 


In general a full computer word is devoted to each 
coordinate of each point and all coordinates are 
expressed as integers. In a 16-bit computer, then, the 
largest expressable positive number is 32767. This is 
sufficient for many applications, but the need to express 
larger numbers sometimes arises. This need can be met, 


at the expense of some loss of resolution in data 
definition, by employing an alternate means of expressing 
data called homogeneous coordinates. Here a point 
(X~V¥-Z) is defined. by the four coordinates 
(hx, hy, hz, he32767),. where "h*® is an arbitrary number 
between zero and one. 


If each of the numbers x, y, and z is less than or equal 
to 32767 in magnitude, "h" would be made equal to one (in 
order to preserve maximum precision) and the expression 
becomes (x,¥,Z,32767). If. one cf the Cartesian 
coordinates, say x, is 50000, the value of homogeneous 
coordinates beccmes apparent because “h" can be made 1/2 
to make x expressable; the point is then defined as 
(12¢50000, 1/2ey, 1/2¢ez, 1/2° 32767) Or 
(25000, 1/2ey,1/2¢z, 16384), all perfectly expressable 
Numbers. It is apparent though that resolution is lost; 
when "h"® is 1/2, it is impossible to exactly express odd 
values for the original . coordinates. In the example — 
above, the expression: -O£ an x. of 50000 is identical. to 
the expression of an.x. of 50001. Furthermore, resolution 
is Icst in all: three ‘coordinates. even if only one of them - 
is out of | bounds. Smaller... walues. of es ae impose — a 
contespantrngl} qrestet loss: of resolution. 


It is. -customa - to. conserve core by suppl ying ont the | 
first three coo dinates. (hx, by ,-bz). ‘for. three-dimensional 
points, or just. “two ‘coordinates. (hx, yay) for two-. 
dimensional points (eith. ‘a common: value for. hz), and tor 
pre-specify a fourth coordinate’ (usually teferred to as. 
My lt) which applies toa several such points. : 


The user. may be: tempted: ‘to assume that relative 
coordinates are another method of extending the bounds of 
the data space beyond the normal limit of 32767 (e.q. 
setpoint to (30000, 30000) , draw relative. to 
(20000,20000), . leaving the beam ~ positioned at | 
(50000,50000)). Such is not the case and.an. attempt to 
accumulate relative positions beyond the maximum 
representable values will cause wrap-around, i.e a 
humber of opposite sign and erroneous magnitude will 
result. 
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PICTURE PREPARATION 


The data base is almost never identical to the display 
file because the data base represents some _ scene, Or 
collection of structures while the display file 
represents some view of that scene. To create a display 
file, transformation of the data base is required. In 
order to prepare a structure for display, it may have to 
be changed in size, position, or orientation; it may have 
to be put in perspective as seen from a given vantage 
peint; parts of it may have to be removed to keep 
everything within a given field of view; and its 
coordinate system may have to be changed to conform with 
the output device. All of these steps can be expressed 
mathematically and implemented in software or hardware. 


It is possible to implement the picture preparation steps _ 
in software using a general-purpose computer, but this is 
relatively slow. Hardware, while less flexible, is much 
faster. Fortunately, many of the steps involved in 
picture .preparation are invariant from application to 


application which makes it very worthwhile to implement’ | 
-them with special — purpose hardware. Any calculations. © 


unique to a aeven application’ can pert be performed i 


To meet’ the ‘dewaud ° “£68 “geet” “‘frane creation, —high- 
performance GEaphLes ‘systems. employ special purpose 
hardware -processors to implement the picture preparation 
te described: in the Wext sections. :° 


Simple Lineac Peangtorpa tious: 


Linear tranetormations (rotations, translations, 
scalings, etc.) can be described by parameters which 
indicate the type and degree of transformation. If the 
transformation parameters are properly arranged into a 
matrix, a vector ‘of original coordinates can be 
multiplied by this matrix to yield a vector of new 
coordinates reflecting the desired transformation. 


A 4x4 matrix can represent any rotation, translation or 
change in scale and can be used to transform points 
represented by homogeneous coordinates or as special 
cases, two- or three-dimensional coordinates. 


This matrix expression of transformations is used because 
of its simplicity and because system design can then take 
advantage of the large body of knowledge about matrix 
arithmetic. 


Compound Linear Transformations 
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All linear transformations can be expressed aS a sequence 
of simple translations, rotations and changes in _ scale. 
A transformation expressable only by such a sequence is 
called a compound transformation. When a . compound 
transformation is to be applied to a set of points, it 
would be possible, but extremely time-consuming, to apply 
the first simple transformation to the original 
coardinates, then apply the second transformation to the 
resulting coordinates, and so forth, for each point in 
the set. Enormous savings can be introduced, however, by 
taking advantage of the fact that matrix multiplication 
is associative: it is equivalent to first forming a 
compcsite matrix by multipling ‘together matrices 
representing all the simple transformations in the 
sequence, in the same order in which the data would have 
encountered the original tranformations and then applying 
this composite matrix to all points to be transformed. 
The process is known as transformation concatenation. 


Perspective 


‘ie me dagelatively straightforward to. prepare. two- © 


dimensional data for display on a two-dimensional mediun. 
Three- dimensional ‘data may be converted to two dimensions 
after transformation by simply dropping the depth (or z) = 
dimension. | The’ ‘resulting » ‘picture, however, - would not oe 
look ‘Eealistic’ ‘because in. zeal life the depth dimension 
hasan ““eHrOr nous ‘effect | n the-appearance of. the. 
horizontal and vertical eer en This effect,. known : 
as perspective, accounts for the convergence of parallel . 
lines in the distance. 


The perspective operation entails computing a point 
projection of three-dimensional points onto a _ plane 
representative of the screen, as depicted in Figure 2.3- 
1. Ferspective can be applied to three-dimensional data 
by taking advantage of the fact that the perspective 
transformation is expressable in matrix form: a 
perspective transformation matrix can be included at the 
end of the sequence of rotation, translation, and scale 
matrices to transform three-dimensional data into a two- 
dimensional perspective representation. 


Windowing 


In some graphics applications, the data base is to be 
displayed in its entirety on the screen. Often, however, 
a closeup ot scre portion of the data base is desired and 
the rest is preferably omitted. Determining what to omit 
is not easy, and is particularly difficult if parts of 
the data base have been transformed. In fact, this 
determination is so time-consuming in software that it 
jeopardizes the dynamic novement of the picture. 


Sophisticated graphics systems address this so-called 
windowing problem by performing a visibility check in 
hardware after the transformation stage and drawing only 
visible lines on the display. One implementation of 
windowing is called clipping and entails comparing all 
lines with the boundaries of a program-specified field of 
view superimposed on the data base. Lines or portions of 
lines outside the field of view are eliminated and only 
visikle lines are passed on for display on the screen. 


In two dimensions, the field of view is a rectangle 
called a window, superimposed on the plane of the data 
base. Clipping is easiest if the sides of the rectangle 
are parallel with the coordinate axes; however, this 
presents no restriction since the effect of a rotated 
window can be obtained by rotating the data in the 
opposite direction. 


A window is specified by supplying values for its left, 
cight, bottom and ‘top. boundaries using the same . 
coordinate system used in the data base. Two-dimensional... 
clipping is diagrammed in Figure 2.3-2. a ee Eee! 


In three dimensions” the field of view is a three-- 
dimensional region. It may be a rectangular volume, or, 


if its contents are to be seen in perspective, a section — 
of a pyramid called a frustrum of vision. Such “a... 
frustrum is shown in Figure 2.3-3 alonq with the. 


parameters necessary to completely specify it. 


in Figure 2,.3-3 an eye poSitioned at point E along the Z 


axis is to see the portion of the data base that lies 
within the frustrum whose hither (near) boundary is at 
pcint H, yon (far) boundary is at point Y, and whose side 
boundaries are determined, as in the two-dimensional 
case, by the window left, right, bottom and top 
boundaries at the hither plane. 


As in the two-dimensional case, lines are retained, 
completely eliminated, or partially eliminated depending 
on whether they are completely within, completely 

outside, or partially outside the frustrum of vision. 


Another approach to windowing is called scissoring. 
Scissoring entails making available a screen coordinate 
drawing space which is somewhat larger than the screen 
itself and then intensifying: only the lines and line 
segments actualiy cn the screen. Scissoring is easier to 
implement than clipping and does not take up time in the 
picture preparation stage. On the other hand, scissoring 
permits an effective drawing area only slightly larger 
than the screen as opposed to the vastly larger effective 
drawing area permitted by clipping. Another disadvantage 


of scissoring is ‘that the line generator spends tine 
tracing out all lines hoth visible and invisible, which 
makes flicker occur more readily. 


Conversion to Screen Coordinates 


Coordinate data that is not rejected by the clipping 
process is within limits determined by the field of view 
which may be of any size and at any position in the data 
kase definition. space.. However, 1t 1s generality 
undesirable to display that data in a corresponding size 
and position on tee. ‘screen. Rather, the data should be 
properly scaled (or. Mapped) so. that it fills some 
peogsau-shecitied cedicn on the screen called a viewport. 
This can be accomplished by performing a final processing 
step which Tinearly. ‘maps all data from the window to the 
VASEEOES® : 
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Left Blank Intentionally. 
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Figure 2.3-1 


Three-Dimensional Perspective Projection 
cnto a Two-Dimensional Plane 


WINDOW WINDOW 
LEFT RIGHT 


Ww , | 
WINDO 


TOP 


LINE LEFT INTACT BY THE 
CLIPPING PROCESS 


LINE SEGMENT REMAINING 
AFTER CLIPPING PROCESS 


BOTTOM: 


‘e . - soe ioe Ce eae LINE SEGMENTS REMOVED © 
re, +3 4. BY THE CLIPPING PROCESS 
: ieee - LINE ENTIRELY REMOVED | 
- . _ BY THE CLIPPING PROCESS 


Figure 2.3-2 
{Two-Dimensional Clipping 


Figure 2.3-3 


Frustrum of Vision showing the Eye Position in Relation to an 
Arbitrary Coordinate Axis 


If the viewport is a rectangular region aligned with the 

screen axes, it can be specified by supplying the screen 
coordinates for its left, right, bottcm and top edges. 
If the system's Line Generator can draw lines of varying 
intensity, a viewport may also specify the intensity 
limits for the data displayed. These limits specify the 
intensities of the data at the hither and yon boundaries 
and are called the hither and yon intensities. When the 
hither and yon intensities are different, the intensity 
of the displayed picture elements varies between these 
limits, allowing an illusion of depth to be imparted to 
the picture. Thus, a viewport is used to specify the 
region of screen and the intensity limits for the data to 
which, in the most general case, the frustrum of vision 
is mapped. Figures 2.3-4a and b show how data may be 
displayed within a viewport which is the entire screen or 
only a portion of it. Viewports may also be utilized to 
map data into the coordinates of devices other than a 
display. For example, viewport boundaries could be 
specified in the coordinate system of a _ flotter or 


similar device | to provide the capability of obtaining ... 
hard Copy Guepat to the PEGCES TORE of the plotting . device... 


An advantage of _program-specified viewports is. eae a 


several -may be assigned in the same program -each:: 
receiving. -@ifferent . ‘data. This technique proves «- 
convenient for many purposes in graphics, Such as showing 


different views of ° an object or views in different. 
directions from the ‘same point cn the Same output ROW ECE: i. 


simultaneously. 


Text Display 


Almost all graphics applications call for the 
presentation of alphanumerics on the screen at one time © 
or another. It is cf course possible to define character 
shapes in the data base like other picture elements and. 
in fact this is necessary if characters are to be treated 


like other objects, i.@., rotated, clipped, etc... 


However, it is possible to derive efficiencies from the 
foreknowledge of character properties when they do aot 
require such sophisticated treatment, by generating the 
actual strokes of the characters just prior to drawing 
them and dealing only with character codes up to that 
pcint. 


A hardware device which accepts character codes and 
produces the strekes comprising the character is called a 
character generator. Character generators generally 
provide flexibilities in the size, shape and orientation 
of the characters they produce. 


Partial Screen Viewport 


“Figure. 2.3-4a ° 


VIEWPORT 


Figure 2.3-4b 


Full Screen Viewport 


To use such a device to draw a string of characters, a 
display proqram must first stipulate character. size, 
shape and orientation values; then position to where the 
string is to beqin and insert a set of packed character 
codes, called a text string, into the display file. The 
character generator would then interpret the text string, 
look up the set of strckes associated with each code, 
size and orient the strokes properly and draw the 
characters on the output device. Codes are packed into 
text strings as a memory conservation measure. 
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PICTURE INTERACTION 
Sophisticated qraphics applications often require that 
the form or content of the picture be changeable by the 
user. A humber of input devices for this purpose are 
generally made available and each has its strong points. 


A ccmmon input device is the light pen which is a light 
sensitive stylus connected to the computer. When the tip 
of the stylus is held against the screen and over a line 
segment, an interrupt is generated. The computer can 
then determine what line in the display file was being 
pointed at. : 


Function switches are frequently attached to the computer 
in a graphics system. These:are toggle switches or push 
buttons whose polarity can be read. Each switch can be 
assiqned a meaning unique to the progran. 


Several analog input devices are sometimes used for 
interaction, including control dials, joysticks and. 
trackballs. These devices. offer one or more degrees of 
freedom over which a user can enter input values used to 
control: rotation, translation, scaling, etc. : 


A versatile interactive input device is the tablet, which 
is a flat tectangular piate which may be positioned on a: 
table in .-frent of, or |near, the display screen... 
Associated with the tablet is a pen which may be moved | 
about over the plate and whose position on the plate may. 


be read with fine resolution by the computer controlling = 
the system. The computer can also detect whether the pen ~ 


is actually touching the plate and may also indicate if 
the pen is near the plate. To tie pen motion together 
with a picture, a cursor is generally drawn on the 
screen. This cursor is a small symbol which continually 
moves about in concert with the pen. It soon becomes 
natural tc guide the cursor'to a desired position on the 
screen by an appropriate | motion of the pen. 
i 

A tablet is considered the best input device for entry of 
precise positional information. It can also be 
programmed to perform the functions of function switches 
or the analog devices. In order to enable a tablet to 
perform the pointing function of the light pen, the 
system should be equipped with a hit test feature which 
checks all data as it emerges from the transformation 
stage for proximity to the pen poSition. The user 
positions his cursor over the target structure and 
initiates the hit test feature (perhaps by touching the 
pen down). If a target structure is encountered a flag 
is set which may be later tested or may be programmed to 
cause an interrupt. This method of pointing has the 


advantage that the’ ‘target structu 
base, not the display > ‘tiles 


| 0 ae 
impossible to backtrack from an entry in the-diesley” ee 
to find its corresponding entry in the data base. 


The tablet also has a human engineering advantage over a 
light pen. The user of the tablet is allowed to sit ina 
natural writing position and at any distance desired from 
the graphic display. This reduces user fatigue and 
improves operating conditions. 
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CHAPTER THREE 


OVERVIEW OF THE PICTURE SYSTEM 


This chapter provides an overview of the hardware 
components which comprise THE PICTURE SYSTEM. A 
functional diagram of the Standard Configuration of THE 
PICTURE SYSTEM is shown in Figure 3-1. The user of THE 
PICTURE SYSTEM will normally interface with these 
components by means of the Graphics Software Package 
described in Chapter 4 of this manual. The user should, 
however, gain a functional understanding of the hardware 
components to fully understand the use of the graphics 
software provided with THE PICTURE SYSTEM. 


PICTURE 
GENERATOR 


REFRESH 
BUFFER 


PICTURE 
PROCESSOR | 


PICTURE 
CONTROLLER 


{cpop-tn) | 


‘L.] character. 
| GENERATOR | 


Figure: 3-1 


The Standard Configuration of THE PICTURE SYSTEM 


PICTURE 
DISPLAY : 


THE PICTURE CONTROLLER 


The Picture Controller in THE PICTURE SYSTEM is a Digital 


Equipment Corporation PDP-11 computer. The PDP-11 is a 


powerful 16-bit general purpose computer which provides 
the capability of interfacing a large number of . 


peripheral devices for standard system support as well as 
options for specialized data acquisition or 
communications applications. In addition, extensive 
software consisting of paper tape, DECtape and disk 
systems is available for the PDP-11 family of computers. 
Software available also includes a Text Editor, Macro 
Assembler, Linker, File Utility Packages, Debugging 
Packages and higher level languages including BASIC and 
FORTRAN. The availability of these software systems and 
the Graphics Software Package provided with THE PICTURE 
SYSTEM enables the PDP-11 to act as -the Picture 
Controller. 


The Picture Controller is used to: 


° ‘Contain the data base which describes 
the object(s) to be viewed. 

* Control the. processing of the object 
coordinate: data by the Picture Processor. 

* Perforn all input. and output reguired 
to. facilitate ' graphical interaction. - 

° Compute parameters for.use in simulation 
of object movement, data representation, etc. 

e Perform all standard operating functions _. 
reguired by the operating system under which 
the contrel . program executes. 


The Picturé Controller communicates with the Picture 
Processor by an Interface Channel. By means of this 


interface, all commands and data are communicated to the = 


Picture Processor, Refresh Buffer and Picture Generator. 
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THE PICTURE PROCESSOR 


The Picture Processor is controlled by the Picture 
Controller through the use of the graphics software 
provided with THE PICTURE SYSTEM. The use of this 
software provides control over the three basic units of 
the Picture Processor: 


1. Interface Channel 
2. Matrix Arithmetic Processor 
3. Terminal Control 


Interface Channel 


The Interface Channel contains registers which provide 
status and commands to the Picture Processor. This 
interface also handles all data transfers to and from the 
Matrix Arithmetic Processor. 

| 
Matrix Arithmetic Processor 


The ‘Watrix - arithnetic © Processor consists of a 
Transformation Matrix, a: Transformation Matrix Stack, an 
Arithmetic ‘Unit’ and a Parameter. ‘Register File. ' 


the -pransforaation: ‘Matrix: dis: a “ax elenent matrix, where 
le each element is a 16- ~bit word. ~ This 4x4 matrix is used ; 


to transforn - object . ‘coordinate data. It can ‘also ‘be 


concatenated with other Ax Y matrices to obtain a combined © 


transformation. 


The Transformation Matrix Stack is a storage area where 
up to four 4x4 element matrices may be "stacked" or saved 
for future recall. 


The ‘Acithmetic Unit performs all arithmetic operations in 
the Picture . Processor. This includes subtraction, 
addition, multiplication, division and normalization. 


The Picture Processor contains an array of 16-bit 
registers into which parameters specifying ‘viewport 
boundaries, scale factors, etc. are stored and may be 
retrieved. : . 


The Picture Processor utilizes these units to perfora 
digital operations on the data received from the Picture 
Controller. 


These operations are: 
* To process two-dimensional data. 


¢ To process three-dimensional data. 
¢ To push the Transformation Matrix onto 
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the Matrix Stack. 

@ To pop the top 4x4 matrix of the Matrix 
Stack into the Transformation Matrix. 

e To load the Transformation Matrix with 
data from the Picture Controller's 
memory. 

e To store the contents of the Transforma- 
tion Matrix into the Picture Controller's 
memory. 

e To concatenate the contents of the 
Transformation Matrix with a 4x4 matrix in 
the Picture Controller's remory to obtain 
a compound transformation. 

e To load and store the registers of the 
Picture Processor. 

# To check transformed coordinate data for 
visibility by comparison with a two- or 
three-dimensional viewing window. Lines 
or portions of lines outside the window 
are removed by a clipping process so that 
only visible segments are processed further. 
At this point three-dimensional data is 
‘converted to two dimensions by computing | 
perspective or orthographic views. ~: 

e To perform a linear mapping of points fron. 
the object's coordinate system into that of 
the Picture Display. 

Each data ‘coordinate that is transformed may be written 
into the Refresh Memory by the Terminal Control to become 
a portion of the new frame. 


Terminal Control 


The Terminal Control is the unit of the Picture Processor 
that controls the refresh of pictures seen on the Picture 
Display. The function of the Terminal Control is to 
receive data from the Matrix Arithmetic Processor and 
store it in the write portion of the Refresh Buffer. It 
is usually concurrently reading data from the read 
portion of the Refresh Buffer and sending it to the 
Picture Generator. 


THE REFRESH BUFFER 


The Refresh Buffer is a memory (distinct from the Picture 
Controller's) into which processed data is deposited 
still in digital form. This data represents the picture 
to be displayed on the Picture Display. For each frame 
refresh, the Terminal Control reads the data in the 
Refresh Buffer and passes the data to the Picture 
Generator, where the data is converted to analog signals 
to drive the Picture Display. Character strings from the 
Picture Controller pass through the Picture Processor 
unmodified and are deposited in the Refresh Buffer as 
packed character codes. 


The Refresh Buffer may be operated in single or double 
buffer mode under program control. In single buffer 
mode, the entire Refresh Buffer is used to store a single 
display. frame. In this mode, display refresh may be 
initiated ~ from partially updated display frame. In 


double™ -buffer node, one half of the refresh buffer is i 


designated as’ “old frame. and one. half. a new frame. 
bi splay refresh: re “then. ‘initiated ‘from the old frame, 


while’ the nev. frame is being constructed. When the 
_ constructi 


2 of “the” new frame is complete, the . frame 
buffers are. ‘swapped and the newly constructed frame is 


displayed and” 


_space occupied by. the old Staee becomes 
avail ble for new “frame construction. : 2 sah : 


CHARACTER GENERATOR 


Character strings from the Picture Controller pass 
through the Picture Processor unmodified and are 
deposited in the Refresh Buffer as packed character 
codes. When character words are read out of the Refresh 
Buffer, the Terminal Control recognizes these codes and 
calls upon the Character Generator to access a_ read-only 
memory containing character stroking data. The strokes 
are read out of the read-only memory one by one, 
multiplied by a pre-specified sizing parameter, and drawn 
by the Picture Generator on the Picture Display. 


THE PICTURE GENERATOR 


The Picture Generator receives digital data consisting of 
x,y coordinate and intensity information read from the 
Refresh Memory by the Terminal Control JUnit. This 
digital data is converted by the Picture Generator into 
analog signals and used to draw the picture on the 


Picture DLSPLOY = 


THE PICTURE DISPLAY 


The. ~Dicture’ Display - receives analog «signals from the — 


Picture | Generator.» ‘which are used -for.-electron bean 
positioning and .. ntensity control. : The. Picture Generator 
controls beam 4 itioning® and the drawing of all ‘vectors 
and dots on the ‘Picture Display.” : + tt 
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DATA INPUT 


All data is input directly to the Picture Controller in — 
THE PICTURE SYSTEM. Data may be input by any. of the 
various standard peripherals available with the PDP-11 or 
by any of the standard graphical input devices available 
with THE PICTURE SYSTEM. There are four graphical input 
devices supported by THE PICTURE SYSTEM: 


1. Tablet 

2. Control Dials 

3. Function Switches & Lights 
4. Alphanumeric Keyboard 


The use of these standard graphical input devices 
provides all the capabilities normally required for 
gtaphical interaction with THE PICTURE SYSTEM. The 
appropriate use of these interactive devices along with 
the dynamic qualities of THE PICTURE SYSTEM provide the 
user with all of the tools required for a_ three- 
dimensional, truly interactive: graphics systen. 


Tablet 


The “tablet serves _ as the. istandard, general purpose 


_qtaphic: ‘input device in THE PICTURE SYSTEM. The Tablet 
can be -used -for positioning or pointing to the picture 


elements—by use of a pen whose -x,y coordinates are read 


by the Picture Controller. .A "cursor" may be drawn on ce 


the Picture Display to indicate the position of the pen 
on the Tablet. With these capabilities, the Tablet and 
pen can perform the interactive functions usually 
reserved for such graphic input devices as light pens, 
joy sticks and function switches. The Tablet is fully 
software supported under the Graphics Software Package 
provided with THE PICTURE SYSTEMS, 


Control Dials 


Control Dials are available with THE PICTURE SYSTEM which 
permit the user to dynamically vary values which may be 
used to control angles of rotation, scaling factors, 
velocity rates, etc. , 


Function Switches & Lights 


Function Switches & Lights are available with THE PICTURE 
SYSTEM to provide the capability for the user to utilize 
Switches to be used for functions assigned under program 
control. An additional capability available with the 
Switches is that the lights (one per switch) which may be 
used to indicate function switch polarity or for 
displaying programmed information. 


Alphanumeric Keyboard 


The Alphanumeric Keyboard available with THE PICTURE 
SYSTEM is a Standard 61 key, 128 character keyboard which 
may be used for text or data input to the Pictute 
Controller for graphical interaction or other functions 


required by the user. : 


CHAPTER FOUR 


THE FICTURE SYSTEM GRAPHICS SOFTWARE PACKAGE 


The Graphics Software Package furnished with THE PICTURE 
SYSTEM consists of a set of FORTRAN-callable subroutines 
written for the Digital Equipment Corporation PDP-11 
computer using the MACRO-11 assembly language. These 
subroutines are written with the intent of providing a 
user with the full capabilities of THE PICTURE SYSTEM 
without the necessity of the user to interface, on a 
system level, with THE PICTURE SYSTEM hardware. These 
subroutines provide the general user with the facilities 
necessary for writing interactive computer graphics 
programs without the need to comprehensively understand 
the matrix arithmetic utilized within THE PICTURE SYSTEM 
Processor. Instead, the user merely “calls” a subroutine 
to perform a required graphical function; i.e. TRANSlate, 
ROTate, SCALE, read TABLET information, display una 
dvepiay TEXT, etc. 


The graphics subroutines for THE a SYSTEM have been 


written gtdiizing the PDP-11 FORTRAN cailing sequence ©. 


convention of the PDP-11 FORTRAN compiler VO6. This 
calling sequence convention, supported under the DEC RfT- 
11, DOS/BATCH, RSX-11M and RSX-11D operating systems, 
provides the user the flexibility ‘of utilizing argument 
lists that are reentrant or non- reentrant—in_ fora. 


All FORTRAN-callable PICTURE SYSTEM subroutines use the 
standard call by name (as opposed to call by _ value) 
parameter passing technique and specify the non-reentrant . 
inline form of calling sequence!. Those subroutines which 
are not FORTRAN-callable specify no FORTRAN calling 
sequence. Ys 


THE PICTURE SYSTEM Graphics Software Package may be 
separated into two sets of subroutines: 


(1) user subroutines 
(2) system subroutines 


fhe non-reentrant in-line form of calling sequence need 

not be used for the Graphics Software Subroutines. Reference 
Appendix C for specific details of alternate forms of calling 
sequences. 


The user subroutines provide all the capabilities 
_ required for the general graphical application 
programmer. The system subroutines are utilized to 
iuplement the user subroutines and are available to the 
programmer who desires to interface with the systen 
software directiy. 


The user subroutines provided are: 


PSINIT 
VWPORT 
WINDOW 
ROT 

TRAN 
SCALE 
PUSH 

POP 
DRAW2D 
DRAW3D 
CHAR 

TEXT 

INST 
MASTER 
CASH - 
BLINK 
SCOPE. 
TABLET 
ISPDWN 
CURSOR 
HITWIN 
HITEST 
NUFRAM 
SETBUF 
PSWALT 


The systen subroutines provided are: 


BLDCON 
P$SAVE 
ESTORE 
FSDMA 
I$SMaTX 
ERROR 
PSDIV 
PSMUL 


A detailed description of each subroutine is contained in 
the following sections. Chapter 5 should be referenced 
for specific examples of the use of these subroutines. 


4.1 


described here. 


-@HE GRAPHICS SUBROUTINES 


This section describes in detail the subroutines which 
comprise THE PICTURE SYSTEM Graphics Software Package. 
The calling sequence for each of the subroutines and the 
valid parameter values for each of the arguments is 
listed. The specification of optional arguments is 
denoted by the inclusion of tthe argument in brackets 
{ arg]. Arguments that may be omitted entirely are 
designated by [,arg]. In particular, the inclusion of a 
scaling factor [,IW] should always be considered to be 
optional. In this manner the user familiar with the 
homogeneous coordinate system of matrix manipulation has 
the freedcm of utilizing the increased range of data 
values provided by this technique, while the user who is 
unfamiliar with the technique or who has no need to 
utilize it may use the shorter calling sequence. For a 
further description of the use of the homogeneous 
coordinate [IW] refer to Section 5.2. 


Appendix B contains a summary of all FORTRAN and MACRO-11 
assembly calling sequences for each of ._ the subroutines | 
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User Subroutines 


PSINIT 


The PSINIT subroutine is called to initialize THE PICTURE 


SYSTEM hardware and software. The initialization process 


includes the following: 


THE PICTURE SYSTEM Real Time Clock interrupt handler 
is connected to the interrupt vector and set to 
provide automatic refresh of the old frame and timing 
for frame update at the intervals specified by the 
calling argument list. 


All variables are assigned their default values. All 
registers used in the Picture Processor are 
initialized for two-dimensional drawing mode. The 
Picture Processor is set to’display data unrotated, 
untranslated, at full brightness, within a viewport 
which: just fills the display screen. 2 . 


Al “window is set. to. include the entire definition 
_ space (£32767). 2 eae , 


The. Refresh. Buffer. is “get to double buffer abde with _. 
an Snitial. frane. consisting of. a null sccursor. The. . 
_ Picture © Generator Status © ais’ “initializea to solid, _ 
0. ‘28 inch character size, and, -herizontal characters. 
mode. — : 7 


All “Picture Displays {scopes ea ae Bslecteal tor 
cutput. ; go a 


FORTRAN Calling Sequence: 


[ EXTERNAL ERRSUB] 


CALL PSINIT (IFTIME, INRFSH,[ ICLOCK },[ ERRSUB],[ISTKCT], 
[ISTKAD]{ , 1FMCNT }) 


where; 
IFTIME is an integer used to deSignate the number 
of 1/120 second intervals per frame refresh. 
The refresh rates that may be obtained are: 


IFTIME=1 for 120 frames per second 
IFTIME=2 for 60 frames per second 
IEFTIME=3 for 40 frames per second 
IFTIME=4 for 30 frames per second 


INRFSH is an integer which specifies the number of 
frame refreshes which must be completed before 
a frame. update will be recognized. If INRFSH 
contains a value <0, then frame update will be 
allowed upon the next refresh-interval after 
a new frame has been requested. 


‘ICLOCK is an integer variable which, if specified, is 
incremented upon each frame refresh. This provides 
the user with the ability to display items for 
given lengths of- time synchronized - to the refresh 
rate. 


ERRSUB is a subroutine supplied by the user which is called — 
uSing the standard FORTRAN calling sequence upon the 
occurrence of a PICTURE SYSTEM error. One argument 
is passed to the user's error subroutine specifying 
the PICTURE SYSTEM subroutine in which the error 
occurred and the particular error conditicn encounter- 
ed. The argument is of the following form: 


EYTE 0: PICTURE SYSTEM Subroutine Identifier 
(0-22). 
EYTE 1: Error condition code. 


The specification of the user error subroutine 

is optional. The system subroutine PSERRS will be 
called if the user error subroutine is omitted from 
the marameter list. 


ISTKCT is an integer which specifies the number of 16-word 
continuous arrays allocated as software matrix stack 
area. The amount of matrix stack area that need be 
allccated by the user is dependent upon the level 
of Picture Processor Matrix Transformations that are 


ISTKAD 


IFMCNT 


pushed onto the matrix stack (using the PUSH sub- 
routine) by the user. This argument need be speci- 
fied only if the number of matrix transformations © 
that need be stacked exceeds four, the number. 
implemented with the Picture Processor. 


is an integer array allocated as software matrix 
stack area. This contiguous area need be 16¥*ISTKCT 
words in length. If ISTKCT contains the value 0 

or is not specified, then this argument will not 

be utilized. 


is an integer variable which, is specified, will be 
incremented upon each refresh interval by the number 
of 1/120 seconds that have elapsed since the last 
frame refresh. This provides the user with the 
ability to determine the frame update rate for 


given display segments. 


ASSEMBLY CALLING SEQUENCE: 


PSINIT, 


be called in assembly language by following the 
calling sequence convention, 
illustrate 

are 


PSINIT 


this, 
shown 


the 
here. 
described in this section may 


assembly 


Manner using assembly language. 


be 


as well as all FORTRAN-callable subroutines, may 


FORTRAN 


described in Appendix C. To 
calling 
The other graphics subroutines 
called in a 


seguences for 


sinilar 


EXAMPLE 1:__6-word Parameter List 
MOV #ADR,RS5 ;MOVE THE ADDRESS OF THE ARGUMENT 
;LIST TO R5 
JSR PC,PSINIT ;JUMP TO THE SUBROUTINE 
ADR: BR ~+14, ;SPECIFY NO. OF PARAMETERS AND 
; BRANCH : 
«WORD IFTIME sADDRESS OF REFRESH RATE ; 
eWORD INRFSH sADDRESS OF FRAME UPDATE RATE 
~WORD ICLOCK sADDRESS OF CLOCK INCREMENTAL WORD 
«WORD ERRSUB sADDRESS OF ERROR SUBROUTINE 
eWORD ISTKCT s;ADDRESS OF MATRIX STACK COUNT ne 
eWORD_. ISTKAD sADDRESS OF ARRAY RESERVED FOR STACK 
EXAMPLE 2: 7-word Parameter List — 
~ MOV -#ADR,R5 ;MOVE THE ADDRESS OF THE ARGUMENT 
= LIST TO R5 
“ISR PC,PSINIT ;JUMP TO THE SUBROUTINE _ 
ADR: BR | +16. | ;SPECIFY NO. OF PARAMETERS AND | 
SY ea ee ee ; BRANCH i : ge FOP ae ie 
~WORD IEFTIME ;ADDRESS OF REFRESH RATE ©... 
~WORD INRFSH ADDRESS OF FRAME UPDATE RATE | 
~WORD ICLOCK sADDRESS OF CLOCK INCREMENTAL WORD 
«WORD ERRSUB ;ADDRESS OF ERROR SUBROUTINE 
eWORD ISTKCT sADDRESS OF MATRIX STACK COUNT 
-WORD ISTKAD s;ADDRESS OF ARRAY RESERVED FOR STACK 
»~WORD IFNCNT sADDRESS OF REFRESH INTERVAL 
s; INCREMENTAL WORD 
IFTIME: WORD 3 sREFRESH RATE OF 40 FRAMES/SEC 
INRFSH: «WORD 0 ;DYNAMIC UPDATE RATE 
ICLOCK:; »WORD 0 ;WORD TO BE INCREMENTED EACH 
; REFRESH 
ISTKCTs «WORD 1 ;DEPTH OF USER MATRIX STACK 
ISTKAD: =.+32. s;RESERVE 16 WORDS FOR MATRIX STACK 
IFMCNTSs WORD 0 ;WORD TO BE UPDATED EVERY REFRESH 
. ; INTERVAL 
ERRSUB; ;USER*S ERROR SUBROUTINE 


The user should note that the address of the parameter 
list is passed to the ‘subroutine in R5 and that the 
elements cf the parameter list are the addresses of the 
arqusents. te 


1,0: Invalid number of arguments in the parameter list. 
1,13 Invalid parameter values. This error may be 
caused bys: 
IFTIME<O. 
ISTKCT<O. 


ISTKAD omitted in parameter list for ISTKCT>O. 
1,2: Direct Memory Access Error. This is a system 
error indicating that an error occurred during the 
last DMA operation. 


YWPORT 
The VWPORT 


subroutine is called to set a viewport specified be 


the values supplied by the calling parameters. 


FORTRAN Calling Sequence; 
CALL VWPORT({IVL,IVR,IVB,IVT,IHI,1IYI) 


wheres 
IVL 


IVR 


IVB 


Ivt 


“THI 


-. EyI 


is an integer which specifies the viewport left 
position in display screen (or other output medium) 
coordinates. Normal range for IVL is -2048 to 2047. 
is an integer which specifies the viewport. right 
position in display screen (or other output medium) 
coordinates. Normal range for IVR is -2088 to 2047. 
is an integer which specifies the viewport botton 
position in display screen {or other output medium) 
coordinates. Ncrmal range for IVB is ~2048 to 2047. 
is an integer which specifies the viewport top 
position in display screen (or other output medium) 
coordinates. Normal range for IVT is ~2048 to 2047. 
is an integer which specifies the display intensity 
at the hither. clipping plane. The normal range for 
IHI is 255 for full intensity to 0 for no intensity. 
is an integer ‘which. ‘specifies the display intensity © 


at tae yon clipping plane. » The normal range for 


yt is 255 for ‘full pacenetey to 0 for no intensity. 


Invalid fins 6: eases the parameter lists— ~-- 


~ WEMpow 


The WINDOW subroutine concatenates a two-dimensional or three- 
dimensional windowing transformation to the Picture Processor 
Transformation. Matrix. This subroutine can be used to perforn 
two-dimensional windowing, orthographic projection or a true 
perspective transformation of data. The windowing transformation 
is constructed from the arguments specified in the parameter 
list. 


FORTRAN Calling Sequence: 
For two-dimensional windowing: 
CALL WINDOW (IWL,IWR,IWB,IWTf,IW ]) 


For three-dinensional windowing: 
CALL WINDOW(IWL,IWR,IWB,IWT,IWH,IWY[ ,LE[ , IW } }) 


where: 
IWL  .is an integer which specifies the scaled window left 
toundary in definition space coordinates (£32767). 
IwRe is an integer which specifies the scaled window right 
boundary in definition space coordinates (432767). 
-IWB is an integer which specifies the scaled window botton 
'.. boundary in definition space coordinates (432767). 
IW? §is an integer which specifies the scaled window top . 
boundary in definition space coordinates (432767). | 
IW is an integer which specifies the scaled window hither 
- boundary in definition space coordinates (+32767). 
For two-dimensional windowing, the window front, or 
ate hither boundary is 0. , 
IwWyY is an integer which specifies the scaled window yon 


boundary in definition space coordinates (+32767). 
For two-dimensional windowing, the window rear, or 
yon boundary is equal to IW. If this parameter=IWH, 
the yon boundary is positioned at infinity on the side 
cf the hither clipping plane opposite fue eye so that 
ho yon clipping will be performed. 

IE is an integer which, if specified, is the scaled 
Z position of the eye. If this parameter is omitted 
or equals IWH, the eye is positioned at -™, which 
produces an orthographic view of the data. 

Iw is an integer used to scale the window boundaries 
and eye position. If the scale factor is omitted, 
cr is given as zero, it is treated as 32767. 


0; Invalid number of arguments in the parameter list. 


ROT : . - aye 
rotation specified in the parameter list. The transformation is 
then concatenated to the Picture Processor Transformation Matrix. 


FORTRAN CALLING SEQUENCE: 
CALL ROT (IANGLE,IAXIS) 


wheres 

IANGLE is an integer which specifies the angle of rotation. 
The angle is given by dividing a circle into 2136 equal 
parts, with zero being equal to zero degrees and -215 
equaling 180 degrees. Two's complement addition, 
ignoring overflow, causes the angle to increase 
counter-clockwise through 360 degrees, when viewed 
along the specified axis in the positive direction. 

TAXIS! is an integer which specifies the axis of rotation. 
Valid values for IAXIS ares 


1 for rotation about X axis. 
2 for rotation about Y axis. 
3 for rotation about Z axis. 


“9,0: Invalid number of arguments in the parameter list. . 
9,1: Invalid argument specified for the axis of rotation. 


ITHE PICTURE SYSTEM software is designed for a left-handed 
coordinate system. 
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TRAN 


The TRAN subroutine is called to build a translation 
transformation based on the X, Y and Z translational values 
specified in the parameter list. The transformation is then 
concatenated to the Picture Processor Transformation Matrix. 


FORTRAN Calling Sequence: 
CALL TRAN (ITX, ITY, 1ITZ[ ,1W]) 


wheres 

ITX is an integer which specifies the scaled X trans- 
lation value. - 

ITY is an integer which specifies the scaled Y trans- 
lation value. 

ITZ is an integer which specifies the scaled Z trans- 
lation value. 

IW is an integer which specifies the factor used to 
scale the translational values. If the scale 
factor is omitted, or is given as aSrOs it is 
treated as. et OT se: 


Os. Invalid number of arguments in the parameter list. 


he 1Z 


SCALE 


The SCALE subroutine is calied to build a scaling transformation 
based on the X, Y and Z scaling terms specified in the parameter 
list. The transformation is then concatenated to the Picture 
Processor Transformation Matrix. 


QRIRAN Calling Sequence: 
CALL SCALE(ISX,1ISY,1S2[ ,IW]) 
wheres: 
Isx is an integer which specifies the X scaling value. 
ISY is an integer which specifies the Y scaling value. 
ISZ is an integer which specifies the Z scaling value. 
Iw is an integer which specifies the factor us2d to 
scale the scaling definition values. If the scale 
factor is omitted, or is given as zero, itis 
treated as 32767. 
ERRORS s 


“17,0: Invalid number of arguments in the parameter list. 


PUSH 


The PUSH subroutine is called to push the current Picture 
Processor Transformation Matrix onto the matrix stack (hardware 
or memory stack, dependent on the current stack depth). 


FORTRAN Calling Sequence: 
CALL PUSH 


6,0: PUSH error (matrix stack overflow). This indicates 
that the matrix stack requirement has exceeded the 
amount allocated by the user during the call to 
PSINIT. 


POP 


The POP subroutine is called to pop the top element of the matrix 
stack (hardware or memory stack, dependent on the current stack 
depth) into the Picture Processor. Transformation Matrix. 


FORTRAN Calling Sequences 
CALL POP 


ERRORS ; 
7,03 POP error (matrix stack underflow). This indicates 
' that the user has attempted to retrieve a matrix 
which had not been previously saved (or pushed) 
_cnto the matrix stack. 


DRAZD 


The DRAW2D subroutine is called to draw two-dimensional data 
coordinate points using the drawing mode specified in the 
parameter list. The data to be drawn is arranged in x,y pairs 
and is displayed at the intensity specified by the IZ parameter. 


FORTRAN Calling Sequence: 
CALL DRAW2D(IDATA, INUM,1F1,1F2,12Z[ ,1W]) 


wheres 

IDATA is an integer array (2¥*INUM words in length) 
which contains the x,y coordinate points. to be 
drawn. This data will be drawn in the drawing 
mode specified by the arguments IF1 and IF2 and 
at the intensity specified by argument IZ. 

INUM is an integer which specifies the number of 
coordinate pairs to be drawn. 


IF1-. is an integer which specifies the type of draw 
> €unetion to be performed. Valid values for IF1 
- ares 5 bye ig 
-Q = disjoint lines from new position. . 
1 = disjoint lines from current position. 
2 = connected lines from new position. 
3 = connected lines from current position. 
4 = dot at each point. 


IF2 . is an integer which specifies the mode in which 
the coordinates are interpreted. Valid values 
for IF2 are: . 7 


absolute-relative-relative-relative-etc. 


0 = 
1 = relative always. 
2 = absolute always. 
IZ is an integer which specifies the Z position 


of the x,y coordinate pairs drawn. This Z 
position is used to compute the intensity of 
the data to be drawn. A value of 12=0 
will produce lines of maximum intensity when 
drawn using a two-dimensional window?. 
Iw is an integer used to scale the coordinate 
data. if the scale factor is omitted, or 
given as zero, it is treated as 32767. 


Ifthe maximum intensity is specified using the VWPORT 
subroutine. 


ERBORS: - eee iF 
10,0; Invalid number of arguments in the parameter 
list. pea ae 
10,1: Invalid parameter value. 
This error may be caused by: 
, INUM <0. . 
IF1<0 or >4. 
IF2<0 or >2. 
For IF2=0 or 1, IW does not equal that 
of the previous draw. 


BRAW3D 


The DRAW3D subroutine is called to draw three-dimensional data 
coordinate foints using the drawing mode specified in the. 
parameter list. The data to be drawn is arranged in x,y,z 
triplets and is displayed at the intensity dependent upon the 2z 
coordinates and the values specified for the hither and yon 
planes. 


FORTRAN Calling Sequence: 
CALL DRAW3D{IDATA, INUM,IF1,IF2[ ,1W }) 


wheres 
IDATA is an integer array (3*INUM words in length) 
which contains the x,y,z coordinate points 
to be drawn. This data will be drawn in the 
drawing mode specified by the arguments IF1 
and IF2. 
INUM is an integer which specifies the number of 
. coordinate triples to be drawn. 
=iIF1 "is an integer which specifies the type of draw 
= funeticn to be performed. Walia values: for: IF 


0 = disjoint lines’ frok ‘new “position. 
1 = disjoint lines from current position. 
2 = connected lines from new position. 
3 = connected lines from current position. 
4 = dot at each point. 
IF2 is an integer which specifies the mode in which 
the coordinates are interpreted. Valid values for 
If2 are: 
0 = absolute-relative-relative-relative-etc. 
1 = relative always. 
2 = absolute always. 
IW is an integer used to scale the coordinate data. 


If the scale factor is omitted, or given as zero, 
it is treated as 32767. 


Invalid number of arguments in the parameter list. 
Invalid parameter value. 
This error may be caused by: 
INUM <0 
IF1<O or D> 4, 
IF2<0 or > 2. ; 
For IF2=0 or 1, IW does not equal that of 
the previous draw. 


CHAR 


The CHAR subroutine is called to update the status used bythe 
Character Generator when characters are to be displayed .on the 
display screen. : 
FORTRAN Calling Sequence: 

CALL CHAR(IXSIZE,IYSIZE,ITILT) 


where: 
IXSIZE is an integer which specifies the X character size. 
I¥YSIZE is an integer which specifies the Y character size. 


Valid values for IXSIZE and IYSIZE are: 


-07 inches 
-=14 inches 
e21 inches 
»28 inches 
inches 
042 inches a: 
049 inches © ip reas OES es Joe 
56 inches Oe eared a ; 


WOU EWH oO 
iteue oun 
8 
w 
wn 


The. ‘specification of a value <0 or >7 will cause the 
value to be modified (modulo 8) toa value in the Eange 
0 to 7. ws 


ITILT is an integer Ghich specifies the Konizoneal oa 
vertical tilt status. ‘Valid values for ITILT are: 


ITILT = 0 for horizontal character status. 


IfILt # 0 for 90° counter-clockwise character 
status. . 


ERRORS: 


18,0: Invalid number of arguments in the parameter list. 


TELAT. 


fhe TEXT subroutine. is called. to display: the: text string:: ae 
specified in the parameter. list.. The display of.the text> will. be: 
from the current beam position and at the intensity associated: 
with the last information displayed. The character status will: 

pe that as initialized by PSINIT or. updated. by the CHAR’ 
subroutine if previously called by the user. 


FORTRAN Calling. Sequence: 
CALL TEXT(NCHARS,ITEXT) 


wheres: = 
NCHARS.is.an.integer: which. specifies the number of char- 
acters. to be displayed. 
ITEXT is an integer array which contains the text to be 
displayed, packed two characters per word, with 
the right. byte tobe displayed first (as in.a FOR- 


IRAN: DATA: statement). __ a 


" 12,03: Invalid, number. of: arguments in the parameter list.. ee Oe 
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ZNST 


The INST subroutine concatenates a two- or three-dimensional 
instancing transformation to the Picture Processor Transformation 
Matrix. This subroutine is used, in conjunction with the MASTER 
subroutine, to produce multiple instances of an object or symbol. 
For each desired appearance of the object, the INST subroutine is 
called to specify the location (and implicitly the size) of that 
appearance; then the user-supplied routine describing the object 
is called to display the object previously defined within a two- 
dimensional or three dimensional enclosure. The INST subroutine 
pushes the initial Transformation Matrix onto the Transformation 
Stack before concatenating the instancing transformation, so that 
it may be restored (POPped) by the user after the object has been 
drawn. 


FORTRAN Calling Sequence: 


For two-dimensional instancing: 
‘CALL INST(INL,INR,INB, INT ,IW )) 


FOr. th ree- -dimensional instancing: 
CALL INST(INL, INR, INB, INT, INH, INYL, IW) - 


where: ae: os 
INL is an integer which specifies the scaled instance left 
boundary in definition space coordinates (+32767). . 

INR is an integer which specifies the scaled instance right 
boundary in definition space coordinates (+32767). 

INB is an integer which specifies the scaled instance 


bottom boundary in definition space coordinates (432767) 


INT is an integer which specifies the scaled instance top 
boundary in definition space coordinates (432767). 


INH is an integer which specifies the scaled instance hither 


boundary in definition space coordinates (+32767). 


For two-dimensional instancing the window front or hither 


boundary is 0. 

IWY is an integer which specifies the scaled instance yon 
boundary in definition space coordinates (+32767). 
For two-dimensional windowing the instance rear or 
yon boundary is equal to IW. 

IW is an integer used to scale the instance boundaries. 
If the scale factor is omitted, or given as zero, 
it is treated as 32767. 


ERRORS s 
5,0: Invalid number of arguments in the parameter list. 
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_ * SASTER 


concatenates a two-dimensional or three-_ 


The MASTER subroutine I 
dimensional master transformation to the Picture Processor 
Transformation Matrix. This subroutine is used in conjunction 


with the INST subrcutine for 


instancing of data. 


The master 


transformaticn is constructed from the arguments specified in the 
parameter list. 


FORTRAN Calling Sequences 
For a two-dimensional masters: 
CALL MASTER (IML,IMR,IMB,IMT[ ,IW ]) 


For a three-dimensional master: 
CALL MASTER (IML,IMR,IMB,IMT,IMH,IMY[ ,IW ]) 


where: 
‘IML 


IMR 


I MY 


is an integer which specifies the scaled 
boundary in definition space coordinates 
is an integer which specifies the scaled 
boundary in definition space coordinates 
is an integer which. specifies: the scaled 


boundary in definition. ‘Space coordinates. 


is an integer. which specifies the. scaled 


boundary in definition: ‘Space “coordinates | 


is an integer: ‘which ‘specifies: ‘the scaled 


boundary in. definition. “space ‘coordinates 
-. For-a two- dimensional master, the front, 
boundary is’ 0. , 


is an integer which: ‘specifies the ‘Sealed 
boundary in definition space coordinates 


boundary is equal to IW. 


master left 
(432767). 
master right 
(432767). 
Master bottom 
(432767) .. 
master top: 
(432767). 
master hither 
(432767). 


window yon 
(432767). 


‘For a two- dimensional master, the rear, or yon, 


is an integer used to scale the master boundaries. 
If the scale factor is omitted, or is given aS zero, 


it is treated as 32767. 


Invalid number of arguments in parameter 


list. 


DASH 


The DASH subroutine is called to set the Picture Generator status 
such that all subsequent lines drawn will be dashed or non-dashed 
dependent on the value of the argument. 


FORTRAN Calling Sequence: 
CALL DASH{ISTAT) 


wheres . 
ISTAT is an integer which specifies the line mode status. 


ISTAT = 0 for solid line mode. 
ISstat # 0 for dash line mode. 


19,02 Tavalae number of arguments specified in the 
parameter list. 


BLINK 


The BLINK subroutine is ‘called to set the Picture Generator | 


status such that all subsequent lines drawn will blink? or will 
not blink, dependent on the value of the argument. 


FORTRAN Calling Sequence: 


CALL BLINK (ISTAT) 


wheres: 
ISTAT is an integer 
mode. . 
ISTAT = 0 for 
ISTAT # 0 for 
ERRORS: . 
20,0: Invalid 


iData drawn in Blink mode 
90 blinks per minute. 


which specifies the blink/non-blink 


non~blink mode. 
blink mode. 


_Rumber of arguments in the parameter list. 


will blink at approximately 


SCOPE 


The SCOPE subroutine is called to select the Picture Display to which. 
output will be directed. 


FORTRAN Calling Sequence: 
CALL SCOPE(INUM) 


where: 
INUS is an integer which specifies the scope unit to select. 
This will cause the Scope selected to be connected for 


output as well as any previously selected scopes. Valid 
values for INUM ares: 


INUM = 1,2,3,4 to select scope units 1,2,3, or 4. 
INUM <1 or >4 to deselect all scope unit selections. 


(21,03 Invalid number of arguments parameter list. 


TABLET 


The TABLET subroutine is called to read the current pen position 
and status in relation to the tablet. The user may also specify 
initiation of automatic tablet mode. This will cause the current 
pen position to be updated at each frame refresh. This ability, 
used in conjunction with the automatic cursor mode, allows 
completely dynamic cursor tracking irrespective of new frame 
update rate. It should be noted that once the pen information is 
updated with the pen down bit set (bit 1), the pen position will 
not be updated until the user has cleared (zeroed) the pen value 
word (IPEN) indicating that the pen down position has been read 
or until the pen is set down again. 


FORTBAN Calling Sequence: 
CALL TABLET (ISTAT[ ,1X,1Y,IPEN ]) 


where: 
ISTAT is an.integer which specifies the automatic 
tablet Roses 


automatic. tablet mode off. 
“automatic tablet.mode on. . 


ISTAT. 9. for 
Istat + # 0, £0 

The four-argument ‘parameter list is 
” required fo IsTaT #0 and pet tone if 

ISTAT=0.. es 


Ix ae an. Winteger ‘which-is—upaatea with ‘tthe Gunseat go 
-"- X pen position. In automatic. tablet mode, this. 
‘value will be updated upon each frame refresh. 
The approximate limits of IX are +32700. 
7S be is.an integer which is updated with the current . 
Y pen position. In automatic tablet mode, this 
value will be updated upon each frame refresh. 
The approximate limits of IY are +32700. 
IPEN is an integer which is updated with the current 
, pen information. Bit 1 will be set if the pen 
is down and bit 0 will be set if the pen is 
within proximity of the tablet surface. If bit 1 
of IPEN is set then IX and IY will be updated only 
if the pen is down. 


13,0: . Invalid number of arguments in the parameter list. 


ZSPDHN 


ISPDWN (Is Pen DoWN) is a FORTRAN-callable integer function 
subroutine which may be used to determine whether the pen is down 
(ie. pressed against the surface of the tablet). This function 
routine allows FORTRAN applications programs, which do aot have 
the ability to perform bit testing, to test the pen up/down 
status. 


¢ Sie PEN bowN FLAG 
: IDOWN = ISPDWN (IPEN) 
Or 
©. 
C IF PEN IS DOWN GO TO 100 
IF (ISPDWN(IFEN).EQ.1) GO TO 100 
where: 3 | 7 


-..  IPEN is an integer which contains the pen information: 
as returned by the TABLET subroutine. 

OQ ifthe pen is not down. 

1 if the pen is down. 


_ LSPDWN(IPEN) 
ISPDWN (IPEN) 


uit 


CURSOR 


The CURSOR subroutine is called to display a cursor atthe. . 
position specified by the parameter list. The user may also - 


specify initiation of automatic cursor mod2. This will cause a 
cursor to be displayed upon each frame refresh irrespective of 
the new frame update rate. The cursor displayed in automatic 
cursor mode will be at the position specified by the x and y 
position values and within the viewport that had been specified 
at the time of the initial CURSOR call. The cursor displayed 
consists cf a cross whose center is at the x and y position 
specified. 


FORTRAN Calling Sequence: 
CALL CURSOR (1X, 1Y,ISTAT[ , IPEN }) 


wheres 

Ix is an integer which specifies the x cursor position. 
In autcmatic cursor mode, the cursor will be placed 
at the position specified by the contents of this 
word at the time of frame refresh. The value of IX 
should be in the approximate range of £32767. | 

ITY is an. integer. which specifies the y -CULSOT position. 

In automatic: cursor mode, ‘the. cursor will be placed 
at the position specified by the contents of this. 
word at the’ time of frame. refresh. The value of IY 
should be in the ‘approximate Tange of +32767. 


ase, cE STAT ‘is an integer . which epecit ies the automatic cursor 


mode: 


ISTAT = 0 for automatic cursor mode off. 
ISTAT ¥ 0 for automatic cursor mode on. 


IPEN is an integer which, if specified, should be the pen 
information which is returned from the TABLET 
subroutine. The specification of this parameter | 
allows the-cursor to be increased in intensity 
whenever the pen is down providing visual feed- 
back of the pen status. 


4,0: Invalid number of arguments in the parameter list. 


NOTE: In automatic cursor mode, the cursor is displayed the 
viewport that had been specified at the time of the 
initial CURSOR call. This is done by saving the 
addresses cf the viewport values in effect at that time. 
When the cursor is displayed the viewport is set from the 
values found in these addresses, 
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HITWIN 


The HITWIN subroutine is called to specify a window through which 
data will be passed to determine whether data is being drawn 
within a given area. The user specifies an x and y coordinate at 
which to center a window transformation of the specified size. 
This window transformation is then pre-concatenated with the 
transformation in the Picture Processor Transformation Matrix, 
after first saving the original transformation so that it may be 
restored after all hit testing has been completed. The Picture 
Processor status is then set to prohibit all data drawn fron 
being output to the Refresh Buffer. The subroutine then returns 
to allow the user to draw all data against which hit testing is 
to be performed. 


FORTRAN Calling Sequence: 
CALL HITWIN (1X, 1IY,1ISIZE[ , IW }) 


where: 

Ix is an integer which specifies the hit window x 
coordinate. The value of IX should be in the 
approximate range cf +32700. 

ITY is an integer which specifies the hit window y 
coordinate. The value of IY shouid be in the 
approximate range of +32700. 

ISIZE is an integer which specifies che hit winise half 

size. This parameter is used to determine whether 

lines pass within a given distance (1SIZE) of the 
specified point (IX,IY).. 

IW. is an integer used to scale the hit window paraleters. 
If the scale factor is omitted, or is’ given as zero, 
it is treated as 32767. 


5,0: Invalid number of arguments in the parameter list. 


HITEST 


‘The HITEST subroutine is called to determine if any output data 


has passed within a pre-specified hit window (see HITWIN). The 
procedure for this test is of the forms: 


1. CALL HITWIN to set up the desired hit window. 

2. Draw data {DRAW2D and/or DRAW3D) for compari- 
son against that window. 

3. CALL HITEST to determine if there was a "hit". 

4. Repeat steps 2 and 3 as often as necessary, setting 
HITEST argument 2 to a non-zero value on the last 
call to HITEST to restore the former user transformation. 


FORTRAN Calling Sequence: 


CALL HITEST (IHIT,ISTAT) 


where: 

IHIT is an integer which is set to zero by the HITEST 
subroutine if there has been no hit or ‘set to qne 
if there has been.a hit. 

ISTAT is an integer ‘supplied by the user which indicates 

— whether! une hit testing has been completed or 

note. 


IsTat = 0 og ‘internediate hit test. — 
AISTAT. # 0. for final hit test. - . 


The Picture: ‘DEecessox ‘@raneForwa tion: Matrix wii be restored to 
the transformation that existed before the call..to the. HITWIN 


subroutine and the Picture Processor status reset so that all 
subseguent data drawn will be sent to the Refresh Buffer. - 


16,0: Invalid number of arguments in the parameter list. 
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SUPRAS 


The NUFRAM subroutine is called to initiate the switch from 
displaying the old frame data to displaying the new frame data 

& (the actual frame switch does not occur until the appropriate 
refresh interval). 


CALL NUFRAM 


ERRORS: 
None 


SETBUE 


The SETBUF subroutine is called to set the Refresh Buffer to 
single- or double-buffer mode. Once the Refresh Buffer has been 
set to a mode, it may be reset at any time to the other mode. 
The user need call this subroutine only if the Refresh Buffer is 
used in single buffer mode. PSINIT during the initialization 
process sets the Refresh Buffer to the default double buffer 
mode. 


FORTRAN Calling Sequence: 
CALL SETEUF (ISTAT) 


where: 
ISTAT is an integer which specifies the mode the 
Refresh Buffer is. to be set to. 
Valid values for ISTAT are: 


single buffer mode. 
: ‘double -buffer mode. 


Jo 
tl 


ERBORS: Pigott 
ameter rm rcrrr rn 
- 2 2,1 3 


chd'paraueter iat.” . 
a This-error may be caused by: 
_-. ISTAT <1 or D2. : 


PSWAIT 


The PSWAIT subroutine is called whenever it is necessary to wait 
until the Picture Processor and Direct Memory Access Unit have 
completed their present operations before continuing. This is 
used to insure that the data transfer to or from the Picture 


Controller's memory is complete before the data is referenced or 
modified. ; 


FORTRAN Calling Sequence: 
CALL PSWAIT 


ERRORS: 


None 


4.1.2 System Subroutines 


BLDCON 


The BLDCON subroutine is called to perform all trans- 
formation operations and matrix manipulations. 


FORTRAN Calling Sequence: 
CALL BLDCON{ITYPE, IARRAY) 


where: 
ITYPE 


‘TARRAY. 


is an integer which specifies the type of call. 
Valid values for ITYPE and the operation performed 
for each ares: 


O= Initialize matrix stack pointer and stack length. 
j= Load the Transformation Matrix from the 16-word 
- array specified as argument 2. 
z= . Concatenate the Transformation Matrix with the 
16-word array specified as argument 2. 
3=.- Store the Transformation Matrix into the’ 
-46-word array specified as argument 2. 


ys Pop the top element of the matrix stack into 


the Transformation Matrix. ‘ 
5= Push the Transformation Matrix onto ene: matrix . 
stack. 


is an integer array (16 words ; in Length) which is 
used as specified by argument 1. This argument 

must be a 16-word array for only. those. operations: 
which utilize this parameter (operations 1, 2 and 3). 


Invalid number of arguments in parameter list. 
Invalid parameter value (ITYPE < 0 or > 5)- 

PUSH error (matrix stack overflow). This indicates 
that the matrix stack requirements have exceeded 
the amount allocated by the user during ths call 

cf PSINIT. 

POP error (matrix stack underflow)... This indi- 
cates that the user has attempted to retrieve a 
matrix which had not been previously saved (i.e. 
PUSHed) onto the matrix stack. 


PSAVE 


The P$AVE subroutine is calied to save registers RO-R5 on the 
program stack. 


Assembly Calling Seguence: 
JSR PC,PSAVE 


BSTORE 


The R$TORE subroutine is called to restore registers RO- "RS fron . 
the Progra stack. 


Aeeeapiy: Callin g Sequen nce: 
JSR. . PC,RS$TORE , 


The P$DMA subroutine is called to initiate a Direct Memory Access 
(DMA) transfer and check for the correct completion of the 
operation. 7 ‘ : 


assembly Calling Sequence: 
RO = Repeat Status Register (RSR) value 


Ri = DMA word count value 
R2 = DMA base address for transfer 
JSR PC, PEDMA 
ERRORS : 
1,2: DMA error. This indicates that an error occurred in the 


last Direct Memory Access operation. 


L$haTx 


The I$MATX subroutine is called to initialize a 16-word array 
in memory (PS$MATX) to a 4x4 identity matrix. 


Assembly Calling Sequence: 
JSR PC, ISMATX 


ERBORS = 
None 


kd 
Es) 
bes) 
Ipo 


The ERROR. pabtoutine’ is called: “by all PICTURE SYSTEM subroutines 
that. encounter - an ‘eLror condition during the course of execution. 
This subroutine in turn calls the user error subroutine specified 
in the call to PSINIT or the default system error’ “routine. 


SS Se ee Sh ee SSS SS Sh eh SS 


JSR PC, ERROR 
-BYTE  $ICODE,IERR 


ICODE is the error code used to indicate the SaSee 
-  - ef the error detected. 
LERR is the error type used to indicate the error 
condition encountered. 


ERRORS: 
None 


iReference Table 4-1 for the subroutine-error code correspondence 
list. 
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The following two function subroutines are optimized for the 
particular PDP-11 hardware configuration. 


PSDIV 


The P$DIV function subroutine divides the signed divided in RO 
and R1 by the signed divisor in R2, leaving the quotient in R0 
and the remainder in R1, with R2 undisturbed. The quotient bears 
the algebraic sign of the division, while the remainder retains 
the sign cf the dividend. 


Assembly Calling Sequence: 


RO,R1 = Dividend 

R2 = Bivisor 

JSR PC,P$DIV 

ERRORS: Ms . 

v=1- . (overflow condition code set) if the magnitude 

cf the dividend is not less than half that of the 
divisor, or.if the divisor is zero. 

PSMUL 


The P$MUL function subroutine mutliplies the signed multiplicand 
in RO by the signed multiplier in R2, leaving a signed product in 
RO and R1, with R2 undisturbed. 


Assembly _ Calling Sequence: 
RO = Multiplicand 

R2 = Multiplier 

JSR Pc, P$MUL 


ERRORS: 
None 


PICTURE SYSTEM ERRORS 


Error detection by the Graphics Software Package is 
performed to ensure program integrity and to facilitate 
program debugging. A user may make four types of. 
programming errors that will be detected by the Graphics 
Software Package. These are: 


l. The call of a graphics subroutine with an invalid 
number of parameters specified. 

2. The call of a graphics subroutine with an invalid 
parameter value. 

3. The attempt by the user to PUSH the matrix 
stack to a depth greater than that specified by 
the user in the call to PSINIT. 

4. The attempt by the user to POP a transformation 
freom the matrix stack which had not been 
previously PUSHed. 


“When an error is detected by a graphics subroutine, the 


system subroutine ERROR is called with an argument that 
specifies the origin of the @rror detected and the error 
condition encountered. The system subroutine ERROR then 
calls the user error subroutine, specified in the call to 
PSINIT. When called, the user error subroutine will be 
passed a parameter which specifies the origin and type of. 


error detected. The error parameter is of the eonteuene 


form: eee os . 
BYTE 1 BYTE 0 
ICODE,IERR: TERR. | ICODE 
where: ; 
ICODE is the error code used to indicate the origin 


of the error detected. 
IERR is the error type used to indicate the error 
condition encountered. 


A summary of the error codes and their meaning is 
contained in Table 4-1. Return from the user error 
subroutine will result in the termination of the progran. 
If, in the call to PSINIT, the user does not specify an 
error subroutine, the graphics error subroutine PSERRS 
will be called. PSERRS, when called, will output the 
following message to the console terminals: 


ERROR X DETECTED IN GRAPHICS SUBROUTINE YY. 


and terminate the execution of the program. xX and YY 
(YY,X) are the error codes listed in Table 4-1, 


NOTE: Unless the users error subroutine is named PSERRS, . 
the resultant core image created by the LINKER will 
include the graphics error subroutine PSERBRS. 
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‘TABLE 4-1 


SUBROUTINE INFORMATION 


Subroutine Length! Length! Registers 


Name Bytes; , Bytes, Destroyed Error Codes_and Meaning 

1. PSINIT 1250 2342 ' None 1,0-Invalid No. of Parameters 
1, 1-Invalid Parameter 
1,2-Direct Memory Access Error 

2e NUFRAM (1) (1) t None | None 

ce VWPORT (1) (1). None 3,0-Invalid No. of Parameters 

4, WINDOW 216 "7932 None: 4,0-Invalid No. of Parameters 

5. MASTER (4) (4) None 4, 1i-Invalid No. of Parameters 

6. INST (4) (4) . None 5,O0-Invalid No. of Parameters 

JT. PUSH (1) (1) None 6,0-PUSH Error 

8. POP (1) (7) None 7,0-POP Error 

9. ROT 386 602 None . 9,0-Invalid No. of Parameters 
9, i-Invalid Parameters 

10. TRAN 150 226 . . None 8,0-Invalid No. of Parameters 

11. SCALE 138 e 21203) None - 17,0-Invalid No. of Parameters 

12. DRAW2D 260 404 ' None -10,0-Invalid No. of Parameters 
-10,1-Invalid Parameter 

13. DRAW3D. (12) (12) -- None 11,0-Invalid No. of Parameters 

11, 1-Invalid Parameter 

14. TEXT 188 274 |... None 12,0-Invalid No. of Parameters 

15. TAsSLET , 188 274 |. None 13,0-Invalid No. of Parameters 

16. CURSOR 440 662: None 14,0-Invalid No. of Parameters 

17. HITWIN 276 422... >. None ' 15,0-Invalid No. of Parameters 

18. HITEST (17) (17) None 16,0-Invalid No. of Parameters 

19. PSWAIT (1) CV). None None 

20. CHAR 258 402:.:. None 18,O0-Invalid No. of Parameters 

21. DASH (20) (20) — - Nene 19,0-Invalid No. of Parameters 

22. BLINK (20) (20) _ None 20,0-Invalid No. of Parameters 

23. SCOPE (20) . (20) None 21,0-Invalid No. of Parameters 

24. SETBUF 88 72>. None 22,0~Invalid No. of Parameters 


22, I~Invalid Parameter 


iThe numbers in these cclumns within parenthesis (i.e., (1) ) indicate that the 
subroutine is included as part of the subroutine whose number is in parenthesis. 


Be TABLE 4-2 
SYSTEM LEVEL ‘SUBROUTINE INFORMATION 


= Subroutine Length2 a 7. oe 


Name Bytes;, Bytes, . Destroyed Error Codes_and Meaning 
25. BLDCON (1) (1) None ~  Q,0-Invalid No. of Parameters 
: ne 0, 1-Invalid Parameter 
26 RSTORE (1) (1) RO-BS . None 
27. PS$AVE (1). (1)- None None 
28. ISMATX (1) (1) |. . RO »RA,R2 None .. 
29. PS$OUOMA (1) (1) .' None  4,0- Direct Memory Access Error 
30. ERROR (1) (71) None: - Branch to user error routine or 
. branch to graphics error routine PSERRS 
31. PS$DIV (1) (1) RO,R1 Overflow set on error 
32. PS$MUL (1) (1) RO,R1 None 


1fhe numbers in these columns within parenthesis (i.e., (1) ) indicate that the 
subroutine is included as part of the subroutine whose number is in parenthesis. 
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Because a comprehensive set of system diagnostics is 
provided with THE PICTURE SYSTEM, hardware error 
detection is performed to a minimal level. There are, 
however, three error codes which may indicate a hardware 
failure. These are: 


1,2: Direct Memory Access Error. This indicates that 
an error occurred during the last Direct Memory 
Access operation. 


6,0: POP error. This error may be induced by a user 
‘software error or by a hardware failure in the 
Transformation Matrix Stack. If this error occurs, 
an exhaustive software verification should be made. 
If no software error is apparent, the PUSH/POP diag- 
nostic routine may be run to verify the integrity 
of the hardware. 


7,0: POP error. This error may be induced by user soft- 
ware error or by a hardware failure in the Transfor- 
‘Mation Matrix Stack. If this error occurs, an ex- 
haustive software verification should be made. If 
no software error is apparent, the PUSH/POP diag- -- 
nostic routine may be run to verify the integrity 
‘of the hardware. : 
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CHAPTER FIVE 


PROGRAMMING THE PICTURE SYSTEM 


This chapter demonstrates the use of THE PICTURE 
SYSTEM Graphics Subroutines to perform general purpose 
graphics functions. The intent of this chapter is not 
tc provide instruction in programming technique, but 
rather to illustrate the use of the Graphics Software 
Package. Each of the user subroutines described in 
Chapter 4 is used, with typical parameter values, in 
the programming examples contained in this chapter. 


5. 1 


GENERAL PROGRAM STRUCTURE 


Programs written for THE PICTURE SYSTEM generally 
contain the following segments: 


1. Data Definition 
2. Program Initialization 
3. Display Loop 


The Data Definition segment typically contains no 
executable code, but rather contains the data which is 
displayed and with which the user interacts during the 
course of progran execution. The Progran 
Initialization segment usually is executed but once 
during the course of the program, but may provide for 
initialization of values thus allowing a programmed 


restart capability. The Display Loop of typical 


PICTURE SYSTEM applications programs is structured as 
Shown in Figure 5.1-1. This program structure lends 
itself to the interactive environment of THE PICTURE 
SYSTEM by providing data input and update of dynamic 
values for each new frame displayed. The frame update 
rate, or the time required to complete the execution 
of the display loop, has been made independent of the 
frame refresh rate by the Refresh Buffer. This 


feature allows programs to be time constrained only by. 
the frame update rate required for dynamic motion. of © 


the data. displayed. 


of: 


As Figure 5. 1-1 illustrates the display loop consists 


1. Data Input (ice. status of function switches, etc. 


2. Update of Dynamic Values 
3. Picture Display 
4. Frame Update 


This functional program structure insures that: 


a. all dynamic values are updated by the most 
recent data input 

b. the most recently updated values are used to 
create the new frame to be displayed 

C. frame update is completed and (for double- 
buffer mode) the buffers set to be 
Switched allowing data input and the 
update of dynamic values to proceed 
while the buffers are mateens to be 
actually switched. 


Item c, above is important in the design of the 
software the processing power of THE PICTURE SYSTEM 


Loop 


PROGRAM 
INITIALIZATION 


UPDATE OF | 


DISPLAY ) } 
DYNAMIC VALUES 


PICTURE 
DISPLAY. 


FRAME 
UPDATE 


Figure 5.1-1 


General Interactive Program Structure 


systen as it allows maximum utilization of t 
processing Controller and increases the frame updat 
rate. The program structure of Figure 5.1-1 may be 
modified as shown in Figure 5.1-2 to increase the 
frame update rate. A comparison of Figures 5.1-1 and 
5.1-2 shows that the difference in program structure 
is the inclusion of the test for "Data to Input,” 
This test, while not necessary, improves the frame 
update rate by allowing the data input procedure to be 
bypassed unless the user initiated some form of data 
input since the previous frame update. This technigue 
is particularly valuable when used in conjunction with 
the tablet. In this case, menu selection testing or 
hit testing need not be done unless the pen is "down", 
ie.e. touching the surface of the tablet. The TABLET 
subroutine may be used in automatic or non-automatic 
mode to perform this function. The user need only 
test the IPEN parameter to determine whether data 
input is to be done from the tablet (see Section 
5.11). 


The program structure of Figure-5.1-1 may be further ~ 
modified to increase the response of the system to | 
data input and provide that frame update be done only | 
as required. This new program structure, shown in ° © 
Figure 5.1-3, is a modification of Figure 5.1-2 in.~ 
that a test for Values to Update" is made prior to the 
"Update of Dynamic Values". This test allows a more... | 
efficient use of the Picture Controller, since a new” 
frame is created only if a portion of the picture is 
changed. The inclusion of this test is a function of © 
the program design and the particular application of 
the program. For example, if a picture contains an 
object which changes with each frame update, the 
inclusion of the test would be superfluous, but if a 
picture is essentially static and changes only upan 
user interaction, the response to user input will be 
improved by the inclusion of a test of this type. If 
should be noted that the program structures of Figures 
5.1-1 and 5.1-2 create a new frame with each execution 

of the display loop, whether a new frame creation is 
necessary or not. 


If THE PICTURE SYSTEM is operating in a stand-alone 
environment in which graphics display and interaction 
is the only function of the Picture Controller, frame 
update rate is the only time constraint, and the user 
program may remain in the display loop in Figures 5.1- 
1, 5.1-2 or 5.1-3 without concern for processing time. 
However, if the graphics system shares a Picture 
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Program Structure to Increase Frame 
Update Rate 
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Program Structure to Increase Systen Response to User Action 


a Se a 


Controller in a Foreground/Background mode! of 
operation, the display loops in these progran 
structures would be disasterous unless the graphics 
application executed in the Background mode. However, 
a program in the Background mode may suffer in 
response time to user interaction, depending upon the 
Foreground program which -is executing. To overcome 
this difficulty, user programs may wish to utilize the 
program structure Shown in Figure 5.1-4. This 
structure would allow a graphics program to execute in 
Foreground node, with all the priorities and 
privileges afforded a Foreground program, and yet 
allow Background programs to execute whenever 
possible, 


4See RTI-11 F/B Operating System Reference Manual, Digital 
Equipment Corporation. 
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Program Structure for Foreground Execution 
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5.2.4.1. 


SCENE DEFINITION 


All data that is displayed on THE PICTURE SYSTEM may 
be considered to be a scene which is viewed by the 
user. The way in which a scene is constructed is 
dependent upon the coordinate system the data was 
defined in, the definition of the data and the 
transformations which may be applied to the data. The 
following sections describe the coordinate systems 
which are available for data definition and display, 
the manner in which data is defined within these 
coordinate systems and the transformations and the 
order in which they should be applied to the data. 


Coordinate Systems 


The user of THE PICTURE SYSTEM need only be concerned 
with the data space coordinate system in which the 
data to be displayed is defined. However, the user 
may optionally choose to expand the range of the data 
space available or to provide for convenient scaling 
of defined data by use of the homogeneous coordinate 
system. In either case, the image which is ultimately 
displayed is viewed within the screen coordinate 
system of the Picture Display. Following is a 
description of each of these coordinate systems. 


Data Space Coordinates 


The data space coordinate system is the region of 


definition space in which all data which is to be. 


viewed is defined. The data space by convention is 
treated as a left handed coordinate systen. Thus, 
positive xX increases to the right and positive Y 
increases upward, while positive Z increases away fron 
the X~Y¥ plane when viewed as in Figure 5.2-1. Any 
data point may be uniquely represented within this 
coordinate system by providing the x,y,z coordinates 
which define the position of the data point in three- 
space. Within this data space resides all of the 
parameters which define the windowing boundaries, the 
eye position for perspective views, the translational 
values, the scaling values as well as all of the data 
which is to be viewed. The bounds of the data space 
are +215-1, but may be extended to an effective range 
of +239 by using the homogeneous coordinate systen. 


Figure 5.2-1 


The Data: Space Coordinate Systen 
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Homogeneous Coordinates 


All data defined for use on THE PICTURE SYSTEM is 


_treated by the hardware as homogeneous coordinate 


Gata; that is, each data point consists of x,y,Z,w 
coordinates. This coordinate systen was nade 
available to the user because the need to express 
numbers Larger than 32767 (the largest expressable 
integer value of the Picture Controller's 16-bit word 
size) arises in sone applications. The homogeneous 
coordinate system allows the user the capability of 
expressing numbers of +230 in magnitude, by 
representing a point. in three dimensions whose 
coordinates are x,y and z by the four coordinates 
(hex, hey, hez,he32767), where "h" ds an arbitrary 
Number between zero and one. If each of the numbers 
X,¥,z2 are less than or equal to 32767 in magnitude, 
"h" would be made equal to 1 and the expression 
becomes (x,Yy,Z,32767). But if one of the coordinates 
of the point is greater than 32767 in magnitude, "h" 
may be adjusted such that the number is expressable. 
For example, if the data point (100000,60000,-16000) 
were to be expressed in homogeneous coordinates so 
that each of the numbers could be represented by a 16- 
bit integer, "h" could be chosen to be 1/4 resulting 
in (1/4 100000, 1/4 60000, 1/4e- 16000,1/4032767) ‘or 
(25000, 15000, 4000, 8192) . It should be noted that “h" 
could not be chosen to.be 1/2 since this would result 
in an x coordinate of 50000, again unexpressable as a 
16-bit integer. This example illustrates how "h" may 
be chosen. However, it may be required in some 
instances to minimize the loss of resolution that 
results in the conversion of unexpressable numbers to 
homogeneous coordinates. In these instances, the 
following formula may be used to compute an "h" which 
Minimizes the resolution loss: 


Jmaximum x,y or z coordinate] 


In the above example, this would result ins: 


1100000} 
or the homogeneous coordinates: 


(32767, 19660,-5243, 10737) 


Usually though, a convenient value (Such as 1/2, 1/4, 
1/10, etc.) may be chosen for “h"® which yields 
homogeneous coordinates whose loss of resolution is 
not significantly greater than if the resolution loss 
had been minimized. 


The previous discussion emphasizes the use of the 
homogeneous coordinate system to extend the effective 
range of the data-space. However, the homogeneous 
coordinate may also be used to define objects 
according to their own coordinate system and scale. 
For example, an object which may have been previously 
defined with 2000 data units/inch as its scale may be 
required to be displayed in relation to a_ similar 


object which had been defined to the scale of 1000. | 
data units/centimeter. One of the objects may be . 
connected to the scale of the other by merely. 
supplying the appropriate homogeneous coordinate (IW) % = 
when drawing .the data using the: -DRAW2D or: ‘DRAW3D. 
subroutine. To determine the appropriate’ homogeneous *. > 
coordinate for ‘this. example. the. following Oanatton 


would | be used: ee a . 

1000 data units 2000 data units ; 
ca "T coutineter | ae ee 
or 


1000 data units 2.54 centimeters 2000 data units 


1 centimeter 1 inch 1 inch 

or 

2540 data units 2000 data units 
h = cen we meee wwenes = wen wn wwnn cue ene 

1 inch 1 inch 

or 

2000 
h = ---- = .78740 

2540 


Therefore, the homogeneous coordinate, IW, would be: 
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IW = .78740032767 = 25800 


The homogeneous coordinate would then be used to 
"scale" the data that was previously defined in inches 


into the centimeter data space, as shown in Example 
5.2-1. “ . 


5. 2. 1.3 


DRAW THE CENTISETER DEFINED DATA 


aan 


CALL DRAW3D (ICENT, 500, 0, 2) 


DRAW THE "SCALED" INCH DEFINED DATA. 


aan 


CALL DRAW3D (INCHS,500,0,2,25800) 
CALL NUFRAS 


Example 5.2-1 


As specified in Chapter 4, there are eight subroutines 
in THE PICTURE SYSTEM Graphics Software in which the 
user may utilize the homogeneous coordinate system. 
They are: 
WINDOW ah 
TRAN j 
SCALE 
DRAW2D 
DRAW3D 
MASTER 
EG Ma ots INST es, ye 
HITWIN 


In each of these subroutines, the inclusion of the 
homogeneous coordinate, IW, is optional so ‘that the 
user who has no need to utilize the homogeneous 
coordinate is not even reguired to specify the 
argument in the calling sequence to the subroutine. 
Those users who initially do not use _ honmogenediis 
coordinates may easily modify their programs to 
utilize their capabilities if required at a later 
time. 


Screen Coordinates 


All data within the data space (homogeneous or not) 
that is defined for display is ultimately mapped into 
the screen coordinate system for display by the 
Picture Generator. This mapping from the dat a space 
to the screen coordinate system is called the viewport 
Mapping and occurs after the data has been 
transformed, clipped and the perspective projection 
performed. This process, accomplished by the hardware 
of the Picture Processor, is transparent to the user 


© 


who need be concerned with the screen coordinate 
system only when specifying viewport boundaries. 


The screen coordinate system for the Picture Display 
of THE PICTURE SYSTEM is shown in Figure 5.2-2. As 
the figure illustrates the origin of this coordinate 
system is at the center of the display screen and has 
a range of -2048 to +2047 display units. This two- 
dimensional screen coordinate system may be considered 
a three-dimensional coordinate system whose third 
dimension is the intensity range of the display. This 
is shown in Figure 5.2-3. It is within this 
coordinate system that all viewports are specified. 
Since viewports may encompass a portion of the screen 
and pictorial data is mapped within the viewport 
boundaries (NOT TO THE SCREEN BOUNDARIES), the screen 
may be used to define multiple viewports. This allows 
the screen to be used to view a single object in many 
orientations or many objects simultaneously. The user 
should be cautioned, however, that should a viewport 
specification exceed the range of the screen 
coordinate system, lines mapped to the edges of the 
viewport will wrap-around to the opposite side of the 


screen. 8 


THE PICTURE SYSTEM 


Figure 5.2-2 


Screen Coordinate System of the 
Picture Display 


DISPLAY 


INTENSITY 


Figure 5.2-3 


The Two-dimensional Screen Coordinate System 
considered as a Three-dimensional System whose > 
Third Dimension is the Intensity Range. 
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Data Definition 


Graphic data that is to be displayed on THE PICTURE 
SYSTEM is defined in the Picture Controller in the 
form of what may be termed a data set. A data set is 
an array of two- or three- dimensional coordinate 
points that are to be drawn in a particular drawing 
mode. 


All data displayed on THE PICTURE SYSTEM is treated by 
the hardware as homogeneous ccordinate data; that is, 
each data points consists of x,y,z and w coordinates. 
Thus two-dimensional data consists of x,y pairs with 
constant z and w coordinates (two-dimensional data is 
actually three-dimensional data that resides in a 
constant z plane), and threedimensional data consists 
of x,y,z triples with a constant w coordinate. The 
notation used to represent a data set is illustrated 


in Figures 5.2-4a. and b. All data of a particular 
data: set that is to be displayed should be stored in 

‘the memory ‘of the Picture Controller in a contiguous 
integer array, to facilitate the accessing of the data 

‘by the. Direct Memory Access " (DMA) interface of the 
Picture ‘Processor. To ensure that data is stored as . 
contiguous data elements in memory, the user should | 
. understand ‘the array storage convention of PDP-11 — 
; FORTRAN Iv, summarized as follows: 


"arrays are | eouee in contiguous storage 


locations that are addressed in ascending order 
with the first subscript varying most. a tah 
For. instance, the two-dimensional array N(J,K) 
is stored in the following order:! 

N(Ve1)¢ N(2,1), - - - « N&J_1) 

N(1,2), N(2,2), - + © « N(J,2) 


WU he. oS x e N(J,K) 


1See Reference 3, Part 7, Section 5.3.1 for further details. 


xy, : with constant X,¥,Z w 
XY z and w X5Y52 ¥ 
X3V3 coordinates = x3 ¥3z w 
XnYn Xn Yn Z W 


Figure 5.2-4a 


Two-dimensional data showing: (1) the notation of the 
data set as stored in the memory of the Picture 
Controller (with implied constant z and w coordinates) 
and (2) the equivalent homogeneous data set as 
processed by the Picture Processor. 


“with constant X,Y) 2, ¥ 


_w coordinate = |XpYoZow 
Oo | [XgYg238 
Xn Vp ZpW 
(1) | | (2) 


Figure 5.2-4b 


Three dimensional data showing: (1) the notation of 
the data set as stored in the memory of the Picture 
Controller (with implied constant w coordinate) and 
(2) the equivalent homogeneous data set as _ processed 
by the Picture Processor. 


This convention should be used in the following manner 
to ensure that all two- and three-dimensional data is 
accessed properly: 
All two-dimensional data should be stored in an 
array specified as: 


DIMENSION IDATA(2,n)? 


All three-dimensional data should be stored in 
an array specified as: 


DIMENSION IDATA(3,n)?} 


In this manner the data will appear as: 
IDATA(1,i) = xi 
IDATA(2,i) = yi 

and for the three-dimensional data: 
IDATA (3,i) = zi 


A data set specified as described above may then be 
displayed by calling the appropriate display 
subroutine (DRAW2D or DRAW3D) and providing the 
drawing specifications. Figures 5.2-5a and b show the 
calling ‘sequence -used to display two- and three- 
dimensional data. Although the z and w coordinates 
are constant for a particular data set when used in a 
DRAW2D call, .they may be varied from call to call. In 


this manner, a two-dimensional data-set may reside in. 


any z~plane and all data sets may be scaled (using the 


w coordinate) by any value. It should be noted by the | 
user that the intensity of a picture displayed is. 


dependent upon the z position of the data in relation 
to the hither clipping plane (assuming that depth- 
cueing is being used). Thus to decrease the intensity 
of a data set, the user need only to increase the 
distance of the data set from the hither clipping 
plane (normally the hither clipping plane = 0 for two- 
dimensional display}. 


Data that is displayed on the Picture Display is 
transformed, clipped and mapped to a portion of the 
display screen (viewport mapped) by the Picture 
Processor and stored into the Refresh Buffer for 
display. Because of this, data within the Refresh 
Buffer is referred to as transformed data and may bear 
little resemblance to the original data. 


1Similarly, a one-dimensional array may be used to contain two- 
or three-dimensional coordinate data. 


2-dimensional _ 
data set 


number of 
coordinate pair 


type of draw 
function 


drawing mode 
Z position 


scaling factor 
(optional) 


CALL DRAW2D (IDATA(1,1) ,N,IF1,IF2,IZ,1W) 
Figure 5.2-5a 
‘Calling Sequence for Two-dimensional Display of Data 


3-dimensional 
data set 


number of > 
coordinate trip 


‘type of draw 
function 


drawing node 


scaling factor 
(optional) 


CALL DRAW3D(IDATA (1,1) ,N,IF1,IF2,1%) 
. Figure 5.2-5b 


Calling Sequence for Three-dimensional Display of Data 
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5e2e3.1 


Transformations 


All data that is displayed on the Picture Display is 
transformed by multiplying each coordinate point to be 
drawn by a 4x41 matrix which represents the linear 
transformation to be applied to the data. This 
process is pertormed by the Picture Processor 
hardware, greatly increasing the speed at which the 
data may be transformed and displayed. fhe use of 
linear transformations in the programming of 
interactive graphics programs is discussed in detail 
in the following sections. 


The Identity Transformation 
THE PICTURE SYSTEM initialization subroutine, PSINIT, 


initializes the Picture Processor's Transformation 
Matrix to a 4x4 identity matrix of the form: 


100 
010 
001 
000 


THE PICTURE SYSTEM subroutines which alter the 


transformation matrix do so by matrix concatenation. 
Initializing to the identify matrix assures that the 
Eirst concatenation is equivalent to loading the 
desired matrix. It should be noted that any 
homogeneous vector or matrix may have all its elements 
Multiplied by some non-zero scalar quantity without 
changing its graphic effect at all. Thus, THE PICTURE 
SYSTEM automatically scales all concatenated matrices 
to the greatest value short of overflow, in order ‘to 
preserve arithmetic precision. The 1's in the above 
matrix, therefore, are shown merely for mathematical 
clarity, and in fact, subroutine PSINIT uses the 
value, 16384, in their place. 


IFor an in-depth discussion of the properties and theory of 
Matrices and linear transformations, see Reference 2. 


5.2.3.2 


"$.2.3.3 


‘Compound ‘Stansfornations - 


Sinple Linear Transformation 


All transformations performed by ‘the graphics 
subroutines (i.e. WINDOWing, ROTation, TRANSlation 
and SCAL(E)ing) are simple linear transformations; 
each are expressable as a 4x4 matrix. When called, 
the subroutines create a 4x4 matrix to perform the 
required linear transformation (e.g. ROTate 90°, etc.) 
and concantenate it with the Picture Processor's 
Transformation Matrix to form a compound matrix. it 
the initial contents of the Transformation Matrix was 
the identity matrix, the resultant compound matrix 
would be the simple transformation created by the 
gtaphics subroutine; otherwise, the compound matrix 
would be a combination of the transformations 
previously concatenated and the newly concantenated 
matrix. : 3 


Figure 5.2-6 illustrates the matrix multiplication 


involved in transforming a data point [x y z w] by the 
‘transformation matrix A to get the transformed data 


point [xty'ztu']. “If data is to be displayed without 
transformation in any manner, the Transformation 
Matrix must. contain the identify matrix as shown in 


Figure’ 5. an “T 


A compound. transformation ‘may be thought of asa 
series of two or more 4x4 matrices multiplied together 
as illustrated in Figure 5.2-8. — 


Typically, all transformations that are to be applied 
to a given set of PICTURE SYSTEM data are concatenated 
into one matrix as in Figure 5.2-8, so that the data 
to be displayed may be transformed (i.e. multiplied) 
by the compound transformation. 


[x yz of A | = [xty'ztw'] 


(1) (2) 
Figure 5.2-6123 


Transformation of a data point by a single 
transformation showing (1) the transformation notation 
and (2) the transformed data. 


1In this discussion all data will be represented by @ 
the homogeneous coordinate point [x y z w] which may 


by thought of as a representative data point (two- or 
three-dimenSional) of any data set. 


2In this discussion, all 4x4 matrices will be represented 
by the notation: 


e e e e 

HW S12 “13 14 : 
23) 32233" 34 
&41 &42%43%44 


where "NAME! identifies the linear transformation 
represented by the 4x4 matrix. For a detailed 
discussion of the contents {i.e. each of the 16 
elements) of the 4x4 matrices used in THE PICTURE 
SYSTEM graphics software see Reference 1, Chapter 12. 


3The transformed data [x'y'z'w' ] is usually clipped, 
viewport mapped and stored into the Refresh Buffer 
to be displayed on the Picture Display. 
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[xyzw]] I =[{x'y'z'w]=[x y zw] 


@ (1 (2) (3) 


Figure 5.2-71 


Transformation of a data point by the identity matrix 
I showing (1) the transformation notation, (2) the 
transformed data, and (3) the equivalence of the 
transformed data and the original data. 


Figure 5.2-8 |. 
“Three ‘simple: Transformations and an Equivalent Compound 
aE AneEOr Rate One| 


1In this discussion, the indentity matrix will be represented 
by the notation: 


1000 
I =|]0 100 
0010 
0001 


The associative property of matrices and the use of 
this property in compound transformations are - 
tllustrated in Figure 5.2-9. In this figure, matrix & 
is post-multiplied by matrix B resulting in the 
(compound) matrix AB which is then used to transform 
data points. 


rena [= | =[x y zw] E B 


(1) . (2) 


[x y zw] [as | = [xty*ztw'] 


‘Transformation... of | a data - point by . compound 
' transformations showing (1) the. transformation 


_ Rotation, | (2) the use of the associative property of |. 


matrices, (3) the compound matrix and (4) the 
‘transformed data. 


Figure 5.2-9 is indicative of the technique used to 
specify the transformations used in PICTURE SYSPEM 
application programs. The transformations to he 
performed upon a given set of data are determined and 
diagrammed, IN- THE ORDER THAT THE DATA IS TO ENCOUNTER 
THE TRANSFORMATIONS TO BE PERFORMED.?t A suggested 
order in which transformations may be. performed is: 


The order in which matrices are multiplied is very important 
as. matrix multiplication, in general, is not commutative; i.e. 


Gore aa ili 


1. Scaling of the data (SCALE) 

2. Rotation about the origin of the data (ROT) 

3. Translation of the data (TRAN) 

4. Windowing of the data and setting the angle 
and point of view (WINDOW) 


Figure 5.2-10 illustrates this order of transformation i 
the matrix notation previously defined. 


comp. 


scaLE|| rotx | | Rory | | rorz| | tran | |wrNpow | 1 
tran 
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A Suggested Order in which Transformations may be Performed. 


It should ‘be noted that inclusion. of all of the 
‘transformations is,not wecessary and, in fact, is” 
often undesirable. For example, in displaying two-) 
dimensional data, a rotation about the xX or Y axis 
results in making a three-dimensional picture of two- 
dimensional | data. A suggested order of 
transformations for two-dimensional data is shown in 
Figure 5.2-11. 


{x y 


te : 


fe fn]. fom] [2] = [ES 


Figure 5.2-11 


A Suggested Order in which Two-dimensional 
Transformation may be Performed. 


A comparison of Figures 5.2-10 and 5.2-11 shows that 
the display of two-dimensional data is a special case 
of the more general three-dimensional - case. 
Therefore, all further discussions of transformations 


and - the examples given will be for the three- 


dimensional case. Discussions and examples for. the 


two-dimensional ‘case may be formed in a similar 


manner. 
Figure 5. 2-12 shows the transformation of a data point 
by the transformations of Figure 5.2-10. 


Bede Few eea wl Gt 


fed bod dd fd eed 


~ (1) 


zw = [xty*ztw'] 


(2) (3) 
Figure 5.2-12 
Transformation of a data point showing (1) the use of 


the associative property of matrices, (2) the compound 
transformation and (3) the transformed data. 


TT 
OOS AE 


Once the transformations to be performed on a set of 

data have been diagrammed as in Figure 5.2-12 it is a 
relatiavely Simple task to implement them in a 
graphics application progran. Because the matrix 
concatenation implemented in hardware pre-multiplies 
the existing transformation matrix by the new 
component matrix and retains the result as the new 
transformation matrix, the order in which the 
transformation matrix must be created using the system 
software is: windowing, rotation, translation and 
scaling. Note that this order is the reverse of the 
order in which the transformations will be effectively 
applied to the drawn data. The most recent 
transformation applies first! This is illustrated in 
Figure 5.3-13 along with the FORTRAN subroutine calls 
required to implement this transformation sequence in 
a user program. Usually, the transformation sequence 
would be executed repeatedly by changing the 
parameters in the transformations to produce a dynamic 
picture. The PUSH and POP operation s facilitate 
multiple use of compound matrices. For example, the 
identity matrix might be saved prior to the 
concantenation of the transformations and restored 
after all the data had been transformed and before the 
"next" series of transformations. This technique ‘is 
‘Shown in Pigure 5.2-14. It should be emphasized that. 
the saving.  (PUSHing) and restoring (POPping) of the 
Transformation Matrix is performed in hardware, 
therefore incurring very little overhead. The saving. 
of transformations need not be limited to the identity 

matrix. Any transformation may be saved for future 
recall by similarly PUSHing in onto the matrix stack. 
For example, if the WINDOWing transformation of Figure 

5.2-14 were constant, an increase in frame update rate. 
could be achieved by creating the WINDOW 
transformation only once and saving and restoring that 
transformation rather than the identiy matrix. This 
is shown in Figure 5.2-15. 


Vie 


CALL 
CALL 
CALL 


CALL 


CALL 
~~ CALL 


CALL 


CALL 


+ CALL 


SCALE (ISX,ISY,ISZ) 


PSINIT (300000) 

WINDOW (IWL, IWR, IWB,IWT,IH,IY,IE) 
TRAN (TX,ITY,ITZ) 

ROT (IAZ,3) 

ROT (lay,2) 


ROT. (LAX,1): 


_ 8 


DRAW3D (IDATA,N,IF1,1F2) 


NUPRAM 


Figure 5.2-13 


The Order in which Transformations are Concatenated 
into the Corresponding FORTRAN Subroutine Calls 


Save Identity 
Matrix Here 


cereafen] foo] rr} fos] fou] Gove] - 


[xt y*tztw' ] 


INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT (3,0,¢¢¢) 
SAVE THE IDENTITY MATRIX AND BEGIN THE DISPLAY LOOP 
00 CALL PUSH 
MODIFY. OR OBTAIN NEW TRANSFORMATION PARAMETERS 


SAANABANAN AN 


CONCATENATE THE TRANSFORMATIONS 


ana... 


CALL WINDOW (IWL,IWR,IWB, Iwr, TH, elt elE) 


' CALL TRAN (ITX,ITY, ITZ) | 

' CALL ROT(IAY,3) . 
CALL ROT (IAX,2) © 
CALL ROT (IAX,1) - 
CALL SCALE(ISX,ISY,1IS2Z) 


NOW TRANSFORM THE DATA BY THE COMPOUND TRANSFORMATION 
CALL DRAW3D(IDATA,N,IF1,IF2) 


RESTORE THE LDENTITY MATRIX AND DISPLAY TOTE DATA 


ana aan 


CALL POP 
CALL NOFRAM 
GO TO 100 


Figure 5.2-14 


Diagrammed Saving of the Identity Matrix and the 
Corresponding FORTRAN Code. 


an 


aaAN 


ana aANAaAAAA 


aan 


aan 


Save the WINDOW 
Transformation here 


renew fo} fo] fom). fod! Eom [5] 


[xty'z'w' ] 


INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT (3,0s00-) 
SET THE WINDOWING TRANSFORMATION 
CALL WINDOW (IWL,IWR,IWB,IWT,IH,1Y,1E) 
SAVE THE WINDOWING TRANSFORMATION AND BEGIN THE DISPLAY LOOP 


00 CALL PUSH. 


MODIFY OR OBTALN NEW TRANSFORMATION PARAMETERS 


CONCATENATE THE TRANSFORMATIONS 
CALL TRAN (ITX,ITY,1TZ) 
CALL ROT(IAZ,3) 
CALL ROT (1AY, 2) 
CALL ROT (IAX,1) | 
CALL SCALE(ISX,ISY,1SZ) 
NOW TRANSFORM THE DATA BY THE COMPOUND TRANSFORMATION 
CALL DRAW3D(IDATA,N,IF1,IF2) | 
RESTORE THE ORIGINAL WINDOW THAT WAS SAVED 


CALL POP 
CALL NUFRAM 
GO TO 100 
Figure 5.2-15 


Diagrammed Saving of the Windowing Transformation 
and the Corresponding FORTRAN Code. 
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The ability . to save and restore transformations is a 
powerful capability which can be used to effectively 
increase the speed with which data can be transformed 
and dynamically displayed. An example of this 
capability is a modification of Figure 5.2-15. If the 
data array IDATA were to be displayed twice, in the 
same orientation but SCALEd differently to emphasize 
different aspects of its geometry, the technique would 
be used as illustrated in Figure 5.2-16. This ability 
to nest or stack transformations is available to four 
levels in hardware, and may be extended by the 
software to any level required. 


The capability of merely call ing a subroutine to 
perform a given transformation, the speed with which 
matrices can be. concatenated, the ability to stack 
transformations and the speed with which data can be 
transformed and displayed make the use of 4x4 matrices 
and the associated linear transformations a powerful 
feature of THE PICTURE SYSTEM. 


save the compound save the WINDOW 
transformation here transformation here 


SCALE J 


vvata® bel ted Sek Set bed ct. 


{x4y'z'w! 


Cc 
Cc 


00 


ANAAMAAAN 


an 


SCALE 


] 
INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT (3,0s¢e-) 
SET THE WINDOWING TRANSFORMATION 
CALL WINDOW (IWL,IWR,IWB,IWT,IH,IY,1E) 
SAVE. THE WINDOWING ‘TRANSFORMATION 


CALL PUSH. 


HODIFY, OR OBTAIN NEW TRANSFORMATION PARAMETERS 


CONCATENATE THE TRANSFORMATIONS AND “DISPLAY THE DATA TWICE 


CALL TRAN (ITX,ITY,ITZ) 

CALL ROT (IAZ, 3). 

CALL ROT (IAY,2) 

CALL ROT (IAX,1) 

CALL PUSH 

CALL SCALE (ISX 1,ISY¥1,1S21) 
CALL DRAW3D(IDATA,N ,IF1,IF2) 
CALL POP 

CALL SCALE (ISX2,1SY2,1ISZ2) 
CALL DRAW3D(IDATA,N,1F1,1F2) 


RESTORE THE ORIGINAL WINDOW THAT WAS SAVED 
CALL POP 
CALL NUFRAM 
GO TO 100 
Figure 5.2-16 


Diagranmmed Nesting of Compound Trasnformations 
and the Corresponding FORTRAN Code. 


5.3 ‘PROGRAM INITIALIZATION [ PSINIT] 


Program initialization for PICTURE SYSTEM graphics 
applications programs consists of: 


1. Calling the subroutine PSINIT to initialize 
THE PICTURE SYSTEM hardware and software. 

2. Initiating automatic operations 

3. initializing all user variables to their 
initial state. 


Each of these steps in the program initialization | 
process is described and illustrated in the following 
sections. 7 


5.3.1 Initialization of THE PICTURE SYSTEM Hardware and- 
Sottware 7 


Typically, the first statement in a user applications 
program is the call to PSINIT! to initialize the 
hardware and software of THE . PICTURE SYSTEM. A 
typical call to PSINIT is shown in Example 5.3-1. 


refresh at 40 frames 


/ per second | 
¢ gf _~ dynamic frame update 
_, CALL PSINIT(3,0¢404) _ 


Example 5.3-1 


In this example, typical parameter values have been 
chosen: a refresh rate of 40 frames per second and the 
specification of a dynamic frame update rate. One 
should note that the last four parameters in the 
subroutine call are specified as null parameters 


(@.4eseer0) 2 


1See Section 4.1 for a detailed specification of PSINIT. 


When null parameters are specified, the default values 


are assumed for these parameters. The following is 
the PSINIT calling sequence specification of Section 
a , 


[ EXTERNAL ERRSUB] 
CALL PSINIT (IFTIME, INRFSH,{ ICLOCK },{ ERRSUBJ,{ ISTKCT ] 
/{ ISTKAD ]{ , IFMCNT ]}) 


A discussion of the uses of each of the parameters 
follows: 


IFTIME is used to -specify the rate with which the 
Picture Display is to be refreshed. Typical values 
for this are 2, 3 or 4 indicating refresh of 60, 40 or 
30 frames per second, respectively, appropriate for 
the P4 phosphor of the Picture Display. If the 
current frame refresh has not been completed when the 
refresh interval has elapsed, then the frame refresh 
will occur upon the next 1/120 second interval after 


the frame refresh is completed. Table 5.3-1 contains. 


all valid values and the: corresponding refresh rates 
of TPTINE. 


INRFSH is. re designate the number of frame 
refreshes which must be completed before a frame _ 


é 


update. (NUFRAM) will be recognized. Typically, — 


INRFSH=0 indicates. that. dynamic frame update is... 
desired. “However, certain applications require fixed: 
lengths of time between frame updates. In these... 
applications, this parameter provides this capability. . 


Example 5.3-2 demonstrates the calling sequence which 


specifies that frame update be done no sooner than > 


every 20th of a second. 


CALL PSINIT(3,2s,4¢,-) 


Example 5.3-2. 


LETINE 


a 
SOON AUEWHN = 


TABLE 5.3-1 


REFRESH_RATE 


120.0 
60.0 
40.0 
30.0 
24.0 
20.0 


frames 
frames 
frames 
frames 
frames 
frames 
frames 
frames 
frames 
frames 
frames 
frames 
frames 
frames 
frames 
frames 


per 
per 
per 
per 
per 
per 
per 
per 
per 
per 
per 
per 
per 
per 
per 
per 


second 
second 
second 
second 
second 
second 
second 
second 
second 
second 
second 
second 
second 
second 
second 
second 


The update rate in seconds may. be: conputed fron the 
parameters of the PSINIT call in example 5.3-2 as 
follows: ne 


IFTIME 3° 7 
update rate = <----- * INRFSH = --- * 2 = -- second 
120 120 20 


If a longer interval of time is required to generate a 
new frame, the update rate will automatically extend 
in order for the system to complete the new frame. A 
new frame will not be displayed more often than 
specified by INFRSH but may take longer depending on 
the time required to compute the new frame. Parameter 
IFMCNT may be wtsed to determine the number of 1/120 
second increments required to create a new frame. 


ICLOCK is used to allow user synchronization with the 
refresh | of the display. When specified, this 
parameter incremented. with each frame refresh and . 
_is typically. used to display an item for a fixed :; 
length- of. time (or number of refreshes). For example, 
if ‘a: user. error message is to be displayed for 10 0... 
seconds it - would be programmed as shown in Example. © 
5.3-3. It should be noted that in the example, the 
number “400 used to terminate. the display loop was | 
derived ‘from: a refresh rate of 40 “frames/second ' . 

:  CUFTIAES 3) we, 10. Seconds-= 400 frames. s eT ee | 


CALL PSINIT (3,0,ICLOCK,,,,) 


BEGIN ERROR DISPLAY LOOP 


CALL USER SUBROUTINE TO DISPLAY THE ERROR MESSAGE 


angaa 


CALL ERMSG 
CALL NUFRAM 


Cc 
Cc RESET CLOCKING VALUE 
Cc 

ICLOCK=0 
DONE? 


IF (ICLOCK. NE. 400) GO TO 100 


AaAA=WAaANN 
o 
© 


FINISHED... CONTINUE WITH USER PROGRAM 


Example 5.3-3 
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ERRSUB is a user error subroutine, which if specified — 
may determine where the user error occurred. If no 
user error subroutine is provided, the graphics error > 
subroutine PSERRS! is called to report the occurrence 
of the user error. Typically, the system error 
subroutine is specified by default as Shown in 
Examples 5.3-2 and 5.3-3. The user requiring more 
memory may consider a user error subroutine which is 
shorter in length than PSERRS. It is suggested in 
this case however, that the user error subroutine be 
named PSERRS or that a global symbol PSERRS be 
declared to avoid loading the system error subroutine 


PSERRS. Example 5.3-4 demonstrates the use of a user 


error subroutine which avoids the loading of the 
System error subroutine, PSERRS. 


EXTERNAL PSERRS 
CALL PSINIT(3, 0,,PSERRS,,) 


END 


SUBROUTINE PSERRS 7 : 
STOP | a ee 
RETURN : Ae an # 

END 


; Example 5.3-4 


ISTKCT is used to specify the number of 16 wotd 
contiguous arrays allocated as matrix stack area. 
This is required only if the stacking (PUSHes) of 
transformations exceeds 4, the number implemented 
within the Picture Processor. If this is required, 
ISTKCT is the number of additional levels of matrix 
stack space that are required. 


i1Por Paper Tape software users a halt will occur rather than 
an e ror message being printed out. See Appendix D for 
specific Paper Tape details. 
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ISTKAD is an integer arrray allocated as matrix stack 
area. This contiguous area need be 16*ISTKCT words in 
length. If ISTKCT contains the value 0 or is not 
specified, then this argument will not be utilized. 
Example 5.3-5 illustrates the use of this feature. 


IFMCNT is an optional parameter which, if specified, 
will allow a user to determine the frame update rate 
at which his picture is being created. This parameter 
is intended for information purposes only. For 
example, if a frame update rate of 15 frames per 
second is required, this parameter may be monitored to 
determine if frame update is proceeding at this rate. 
IFMCNT should be initialized (or zeroed) by the user 
each time the frame update rate is to be determined. 
IFMCNT is never initialized by the system software, 
but rather is always incremented upon each refresh 
interval by the number of 1/120 seconds that have 
elapsed since the last frame refresh. Table 5.3-2 
shows the values of IFMCNT for frame update rates down 
to 10 frames per second. Example 5.3-6 illustrates 
the use of IFMCNT. 


ana 


DIMENSION ISTKAD(16,1) 
CALL PSINIT(3,0,¢,1,ISTKAD) 


LEVEL 1 


CALL PUSH 
CALL PUSH 


PUSH 


(2) 
> 
ete 
te 


PUSH 


G 
load 
eso 
al 


POP 
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oo 
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te 


Lees, 
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-PUSH 


a 
oe 


a. 
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PUSH. 


Et 


POP . 


POP 


Q 
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ke 


POP 


POP 
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POP 
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Example 5.3-5 
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IFMCNT 


hb dh od ; 
New OO OWA SW = 


TABLE 5.3-2 

UPDATE_RATE 
120.0 frames 
60.0 frames 
40.0 frames 
30.0 frames 
24.0 frames 
20.0 frames 
17.1 frames 
15.0 frames 
13.3 frames 
12.0 frames 
10.9 frames 
10.0 franes 
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per 
per 
per 
per 
per 
per 
per 
per 
per 
per 
per 
per 


second 
second 
second 
second 
second 
second 
second 
second 
second 
second 
second 
second 


CALL PSINIT(3,0,¢7,,1FNCNT) 


c 
e BEGIN DISPLAY LOOP 
c . 
100 IFMCNT=0 
CALL NUFRAM 
c 
c 
Cc 
IF (TPACHT. LE. 8) 
c a 
c SLOW FRAME UPDATE, 
c 
. . ae =120. GTPBCET | 
2000 — 


ENSURE UPDATE RATE OF AT LEAST 15 FRAMES PER SECOND 


60 TO 100 


RINT A MESSAGE AND THEN CONTINUE 


“aune Es 
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5.3.2 


5.3.2.1 


5.3.2.2 


Initiating Automatic Operations [TABLET, CURSOR] 


The Graphics Software Package provides the facility to 
have certain operations occur automatically. These 
operations are: 


1. The updating of the tablet position and 
status of the pen. 

2. The display of a cursor within an initial 
viewport. 


These automatic operations can be used independently 
or together to provide dynamic pointing capabilities 
without programming effort. 


The automatic operations occur at the rate specified 
as the refresh rate in the call to PSINIT. After each 
frame refresh has been initiated the automatic 
operations that have been “turned on" are performed. 


Automatic Tablet Update 


‘The automatic tablet update is initiated by a call to 


the TABLET subroutine specifying that the tablet is to 
be used in automatic mode as shown in Example 5.3-7. 


‘CALL TABLET (1,1X,1Y,IPEN) 


~—— Example 5.3-7 ae 


In this example, the parameters IX,IY and IPEN are 
variables which are to be automatically updated with 
the x-pen position (IX), the y-pen position (IY) and 
the pen status information (IPEN). This information 
may be used to determine menu selections and in 
conjunction with the CURSOR subroutine to display the 
current pen position. 


Automatic Cursor Display 

Automatic cursor display is initiated by a call to the 

CURSOR subroutine specifying that the cursor is to he 

displayed in automatic mode as shown in Example 5.3-8, 
CALL CURSOR (IX,IY,1) 


Example 5.3-8 


5.3.2.3 


In ‘this example, the parameters IX and IY are the 
wariables which contain the x,y position at which ‘the 
cursor is to ‘be displayed. These parameters are 
usually the values which indicate the x,y position of 
the pen, -but need not be the tablet values and may 
indicate any information. 


Use of Automatic Tablet and Cursor Modes 


Initiation of automatic tablet and cursor modes should 
proceed in the following order: 


1. CALL PSINIT to initialize THE PICTURE SYSTEM. 


2. CALL VWPORT to specify the viewport boundaries?! 


within which the cursor is to appear, if other 
‘than the default boundaries are required. 
3. CALL TABLET to initiate automatic tablet 
update. 
~~. CALL <CURSOR to. initiate automatic cursor 
‘display. |. 


Bixauples %.9- 9 and ‘5. 3- 10 ‘Show the use ‘of automatic 
tablet “and cursor modes. 


“ wodieied ‘eherost tar and the cursor will continue to appear 
Within the dynamically changing viewport. 
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INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT(3,00,4,5,) 


USE DEFAULT VIEWPORT OF ENTIRE SCREEN INITIALIZED BY 
PSINIT FOR CURSOR DISPLAY 


CALL TABLET(1,1X,IY,IPEN) 
CALL CURSOR (IX,IY,1) 


BEGIN DISPLAY LOOP 
Example 5.3-9 


DATA IVL,IVR,IVB,IVT/-2047,0,0,2047/ 
INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT(3,0,s,4,) 
SET UP THE VIEWPORT FOR CURSOR DISPLAY 
CALL VWPORT(IVL,IVR,IVB,IVT, 255,255) 
CALL TABLET(1,IX,1IY,1PEN) 
CALL CURSOR (IX,IY,1) 


BEGIN DISPLAY LOOP 


Example 5.3-10 
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Se 303. 


Initialization af User Variables 


Variables are usually used in an applications program 


to: retain values which are passed to the graphics’ 


subroutines to indicate angles. of rotation,. 
translation values, etc. Upon initial loading of the 
program, these variables will contain their initial 
values. However, if the program is re-started or has 
a programmed re-start facility, these variables will 
contain values which may not be the initial values 
required. For this reason, it is suggested that all 
user variables be initialized before the display loop 
is: he-gun.. Figure 5.3-1 illustrates a suggested 
placement of the user variable initialization process. 
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PROGRAM INITIALIZATION 


USER 
VARIABLE 
INITIALIZATION 


PICTURE 
SYSTEM 
INITIALIZATION 


eens eee 


| 
| 
| 
| 
| 
| 
| 
| 


DISPLAY. 
~[--- PROCESSING _ 


DISPLAY 
LOOP 


NUFRAM 


Figure 5.3-1 


Suggested Program Initialization Structure 
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5.4 


VIEWPORTS [ VWPORT ] 


A viewport is a program-specified rectangular region 
of an output device within which the windowed data is 
mapped for display. Typically, the output device is 
the Picture Display of THE PICTURE SYSTEM. 


Figures 5.4-1a and b illustrate the two- and three- 
dimensional display of data which is mapped into the 
viewport. A viewport is specified for THE PICTURE 
SYSTEM by calling the VWPORT subroutine. The 
following is the VWPORT calling sequence specification 
of Section 4.1: 


CALL VWPORT (IVL,IVR,IVB,IVT,IHI,IYI). 


The parameters passed to the subroutine specify the 


boundaries of the viewport in the coordinate system of 
the output device; viewport left boundary (IVL), 
viewport right boundary (IVR), viewport bottom 


_boundary . (IVB). and-viewport top boundary (IVT). The 
subroutine also provides the ability to specify the | 


intensity at which data will be displayed at the 
hither and yon clipping planes; hither astuccam ae 


and. yon Pat east ty (IYI). 


LS$-S 


WINDOW eatin VIEWPORT 


DATA SPACE SCREEN 
(1) ho (2) 


Figure 5.4-1a 


Two-dimensional clipping and viewport mapping showing 
(1) the two-dimensional window. and data and (2) the 
watt - 2a picture as it would appear on the Picture Display. __ 


(2) 


Figure 5.4-tb 


Three-Dimensional clipping and viewport mapping showing 
(1) the three-dimensional ‘perspective window and data and 
(2) the picture as it would appear on the Picture Display. 


524.1 
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Full Screen Viewport 


The entire Picture Display may be selected asa 
viewport by specifying the maximum coordinate range 
for the viewport boundaries as shown in Example 5.4-1. 


CALL VWPORT (-2048,2047,-2048,2047, 255, 255) 


Example 5.4-1 


A call with these parameters specified would result in 
all data subsequently drawn being displayed within a 
viewport the size of the entire Picture Display. 
Viewports may be specified to be non-square, but this 
causes distortion of the data to be displayed.as 


‘illustrated in Figure 5.4-2. This distortion, caused 


by the linear mapping of the data space into viewport 
coordinates,. may be compensated by an appropriate 
windowing transformation as described in Section 5.5, 
Multiple Viewports— ~~ 

The Picture Display may be used for simultaneous 
Gisplay of different pictures. For example, the 
screen could be used to show the entire street map of 
Figure 5.4-1a and the magnified portion of the map 
simultaneously as illustrated in Figure 5.4-3. The 
statements used to accomplish this are shown in 
Example 5.4-2. The use of multiple viewports on one 
display is a powerful feature of THE PICTURE SYSTEM. 
The ability of THE PICTURE SYSTEM to display data on 
up to four displays allows programs written using 
multiple viewports on one display to be upgraded ata 
later date using several displays to produce pictures 
of full screen size. 


INTEGER IP1(2),IP2 (2) 
DATA IP1/1000, 16384/ 


CALL VWPORT (-2048, 2047,-2040, 2047, 255, 255) 


CALL TEXT (17,*ENTIRE STREET MAP‘) 


aa 


CALL VWPORT (-2048,0,0,2047,255, 255) 
CALL WINDOW (-32767,32767,-32767,32767) 


CALL VWPRORT (-2048, 2047,-2048, 0, 255,255) 
CALL WINDOW (2000, 10192, 12288, 16384) 


Example 5.4-2 


SET THE VIEWPORT FOR THE TEXT AND ANOTATE THE DISPLAY 


DISPLAY THE BRGUEEESD PORTION OF THE MAP 


NOTE THE NON-SQUARE. VIEWPORT AND COMPENSATING 


DATA IP2/8192,0/ 
Cc 
Cc INITIALIZE THE PICTURE SYSTEM 
Cc 
CALL PSINIT(3,90¢54¢¢) 
Cc \ 
Cc SAVE THE INITIAL TRANSFORMATION 
Cc 
100 CALL PUSH 
Cc 
Cc 
Cc 
CALL DRAW2D(IP1,1,2,2,0) 
CALL DRAW2D(IP2,1,2,2,9) 
CALL TEXT (13, MAGNIFICATION®) 
DISPLAY THE ENTIRE MAP 
CALL MAP. 
. CALL POP 
CALL PUSH 
Cc. 
c 
Cc 
c 
Cc NON-SQUARE WINDOW 
c 
CALL MAP 
CALL POP 
CALL NUFRAM 
GO TO 100 
Cc 
END 


ES THE PICTURE SYSTEM 


_ 


Figure 5.4-3 


Simultaneous Use of the Screen to Display an Entire Street Map, 
a Portion of the Map Magnified and Text Anotation using Three 
Viewports to Specify the Portion of the Screen to be Used. 


9S-S 


WINDOW oe dha ese faa ~~ VIEWPORT 


DATA SPACE ieee 2 ye _ SCREEN 


Figure 5.4-2 
A non-Square viewport which illustrates the data 


distortion which can occur if a corresponding non-square 
window is not specified. — 


4 . 


5.4.3 


Depth-cueing 


A heightened sense of perspective may be imparted to 
three-dimensional objects by specifying that depth 
cueing be performed. This feature provides’ the 
ability to vary the intensity of lines as the lines 
become "further away" by specifying differing hither 
and yon intensities when calling the VWPORT 
subroutine. The maximum depth-cueing effect is 
obtained by specifying a maximum hither intensity 
(255) and a minimum yon intensity (0). Example 5.4-3 
shows the use of the VWPORT subroutine to specify 
depth-cueing. 


CALL VWPORT (-2048, 2047,-2048, 2047, 255, 0) 


Example 5. 4-3 


NOTE: The specification of viewport boundaries larger thai 
- the capability of the output device will cause line; 


to wrap-around the device. The maxinun viewport 


bo : boundaries for the Picture DL SPICY are: 


IVL, ‘Ive, IVB, IVT: -2048 to +2047 


IHI, IYI: 255 to 0. 
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WINDOWING [ WINDOW } 


A window is a two- or three-dimensional framework or 
enclosure in the data space. All lines which fall 
within the window boundaries appear on the Picture 
Display while those portions of the lines falling 
outside the boundaries are not displayed. Should a 
line extend from within this region to someplace 
outside it, only that portion of the line falling 
inside the boundaries will be displayed (lines are 
clipped to the window boundaries). This process of 
windowing includes the definition of both an enclosure 
and a point-of-view, that is, the position of the 
observer as shown in Figure 5.5-1a, band c. This is 
in contrast to the positioning (i.e. rotating, 
translating, etc.) and displaying of the data (i.e. 
line and text output) which may be considered to set a 
scene to be viewed. 


The following . are the WINDOW calling sequence 
specifications of Section oe Pe 


CALL WINDOW (IWL, IWR, IWB,IWT[,IW]) . 
5 CALL WINDOW. (IWL, IWR, IWB,IWT,IWH,IWY{ ,IE{ , IW] }) 


These calling sequences allow the user to view a scene _ 


from any number of different positions, and in several° 


different ways. For example, a scene may be viewed in> 
perspective as an orthographic projection or even as a 
two-dimensional picture with no implication of 
apparent depth. The following sections describe how 
the WINDOW subroutine may be used to view a scene in 
these different ways.. 


2D DATA SPACE 


IWT 


IWR 
2D WINDOW 


Figure 5.5-ia 


Two-dimensional windowing showing (1) the eye whose 
X,Y position is at the center of the window and whose 
position is at negative infinity and (2) the window whose 
X,y position is determined by the left, right, botton, 
top parameters ATRL IWR,IWB,IWT) and whose z- position 
ais at 0. 


3D DATA SPACE 


Figure 5.5-1b 


Three-dimensional orthographic windowing showing 

(1) the eye whose x, y position is at the center of the 
window and whose z position is at negative infinity and 
(2) the 3D orthographic window whose’ x,y position 

is determined by the left, right, bottom, top 
parameters (IWL,IWR,IWB,IWT) and whose z position is 
determined by the hither and yon parameters (IH,IY). 
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3D DATA SPACE 


Figure 5.5-1c 


Three-dimensional perspective windowing showing (1) the 
eye whose x,y position is at the center of the window 

and whose z position is determined by the eye position 
parameter (IE) and (2) the 3D perspective window whose 
position at the hither clipping plane (IH) is determined 
by the left,right,bottom,top parameters (IWL,IWR,IWB,IWT) 
and whose yon position is determined by the yon parameter 
«IWy). 
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5. 5.1 


Two-Dimensional Views 


A two-dimensional view is established by allowing the 
X-Y¥ boundaries of the window to be specified, thus 
permitting the side of the WINDOW facing the viewer to 
be shaped into any sort of rectangle and placed at the 
viewer's convenience anywhere on the X-Y plane. This 
is done by a two-dimensional (four-or five-parameter) 
call to the WINDOW subroutine, specifying the 
parameters IWL, IWR, IWB, IWT, and the optional 
scaling parameter IW. The first four define, 
respectively, the left, right, botton and top 
boundaries of the WINDOW. The hither and _ yon 
boundaries remain fixed; that is, the hither boundary 
is set at zero, while the yon is set equal to the 
homogeneous coordinate IW if specified and 32767 
otherwise. 


This transformation is generally used in connection 
with the display of two-dimensional data, since the z- 
coordinate has no effect on the placement of the lines 
in the picture, except to control their intensity. 


Example 5.5-1 shows a call to the WINDOW subroutine to 
set a two-dimensional windowing transformation. 


Cc biz 2 | 
C SET THE 2D WINDOWING TRANSFORMATION 
Cc ‘ 

CALL WINDOW (-20000, -5000,-20000,-5000) 


Example 5.5-1 


5. 522 Three-Dimensional Orthographic Views 


An extension of the two-dimensional WINDOW call to six 
parameters provides for the definition of a 
rectangular parallelepiped (i.e. box-shaped) enclosure 
for the WINDOW, the six boundaries of which are 
directly specifiable, thus allowing the user visual 
access to any portion of the data definition space. 
This is done by adding parameters which specify the 
position of the hither and yon boundaries (IWH,IWY) to 
the WINDOW left, right, bottom and top parameters. 
When called in this manner, a WINDOW is defined which 
is then viewed as if from an infinite distance away. 
The pictures which result are analogous to photographs 
of objects taken at great distances through a 
telescopic lens of extremely high magnification; the 
picture may appear clear and sharp, but evidence of 
perspective is lost. By setting the eye position at 
negative infinity, this same effect is obtained, 
wherein only the x and y coordinates of the displayed 
lines and dots affect the picture, with the z 
coordinate having no effect except perhaps in~ the 
_intensity. of the data displayed. This type of view, 
known as orthographic projection, is specified -by a 
call to the WINDOW subroutine as illustrated by 
Example 5.5-2. i: Bo ; : 


C. SET THE ORTHOGRAPHIC WINDOWING TRANSFORMATION 
Cc 
“CALL WINDOW (-2000,-1000,-2000,-1000 ,-5000,-5000) 


Example 5.5-2 


If the scaling parameter, IW, is required, the IE and 
IW parameters must both be specified to distinguish 
this calling sequence from the standard perspective 
view specification. The IE parameter should then be 

© specified as equal to the IWH value, the convention 
chosen to specify that the eye be positioned at 
negative infinity as shown in Example 5.5-3. 


SET SCALED ORTHOGRAPHIC WINDOWING TRANSFORMATION 
THIS IS EQUIVALENT TO: 
CALL WINDOW (-40000,-20000,-40000,-20000,-10000, 10000: 


(NOTE: IE=IWH) 


AAANAAANAANAAN 


CALL WINDOW (-20000,-10000,-10000,-10000,-5000, 
1 5000,-5000, 16384) i ; oy 


Example 5.5-3— 


@ 5.5.3 © Perspective Views 


When three-dimensional objects are viewed, the viewer 
infers depth from the fact that distant objects appear 
smaller and that parallel lines extending away from 
the viewer appear to come together in the distance. 
This effect may be invoked for three-dimensional data 
{and even for two-dimensional data where the z- 
coordinate is specified as a constant) by calling the 
WINDOW subroutine with the IE parameter not equal to 
IWH. The effect of this subroutine call is to modify 
the shape and position of the six-sided, three- 
dimensional orthographic window so as to produce a 
"frustrum of vision"; that is, a right rectangular 
pyramid, with the top sliced off by a cut parallel to 
the base. If the eye is placed at the position 
previously occupied by the apex of the pyramid, then 
the edges of the rectangular cut will define the 
hither boundaries of the four side walls of the 
frustrum. Anything lying within the frustrum will 


appear to be framed in the rectangle, and will thus be 
viewed when aeaelayed on the Picture Display. 


Seven parameters are supplied in a perspective call to 
the WINDOW subroutine. These parameters completely 
specify the shape and position of the enclosure, with 
the one restriction that the direction of view be 
always along a line parallel to the Z axis. The 
effect of rotational changes to the direction of view 


‘must be explicitly accomplished by calls to the ROT 


subroutine to perform opposite rotations to the 
coordinate data. The position and size of the 
rectangular side of the frustrum closest to the eye 
(known as the hither clipping plane) is uniquely 
determined by the five parameters IWL,IR,IWB,IWT and 
IwWH. These specify its left, right, bottom and top 
boundaries, as well as the Z-position of the plane of. 
the rectangle. The position of the back plane of the 
frustrum (called the yon clipping plane) is specified 
by the parameter IWY, while the 2- position of the eye | 
(centered in front. of the hither plane) is specified 
by IE, as shown: in Figure 5.5-2. An optional eighth 
parameter, iW, may. ‘also be supplied when one or more 
of the other. parameters is too large to be expressed 
directly.. These parameters not only specify the shape 
and. position of .the window enclosure, but also 
implicitly define the. angle of view (@) as follows:! 


-@ .s TWR-IWL 
Tan - = --------- 
2 


| 2 (IWH-IB) 


The angle of view may be varied by adjusting the 
WINDOW parameters to provide an effect similar to a 
telephoto camera lens (viewing angle < 20°) or a fish 
eye camera lens (viewing angle > 40°). 


This defines the X-viewing angle only. The Y viewing angle is 
inferred automatically by the aspect ratio as described in the 
next section. 


\ | / YON CLIPPING PLANE 


Op dT e 
KOK o Y 
4% * TTY 
zZ ON Sb AN 7 
HITHER CLIPPING PLANE : x Cia IWR f wT = IVB oe, 


Figure 5.5-2 


The Frustram of Vision as defined by the WINDOW subroutine 


Non-Square Windows and Viewports 


In specifying a WINDOW (square or non-square) the user 
should display the data within a viewport of a 
corresponding shape to ensure that the data is 
displayed without distortion. This may be stated more 
explicitly by defining the term “aspect ratio". The 
“aspect ratio" of the window is simply the ratio of 
the horizontal width of the window to its vertical 
height, or: 


IWR-IWL 
Window Aspect Ratio = ------- 
IWT-IWB 


In order for data to be displayed without distortion, 
the aspect ratio of the window must be equal to the 
aspect ratio of the viewport. This may be expressed 
in terms of the parameters as: 


IWR-IWL IVR-IVL 
IwT-1wB IVT-IVB ; 


The user should maintain this equality for all types 
of windowing; two-dimensional, three-dimensional 
orthographic and three-dimensional perspective views. 
The-user who desires to—view a three-dimensional 
picture in proper perspective has the additional 
constraint that the angular width of the frustrum of 
vision be approximately equal to the angle through 
which the viewport is observed by the user. This 
means that the user should specify the WINDOW 
parameters such that the frustrum of vision assumes a 
Shape which is proportional to that which exists when 
the user actually views the Picture Display as shown 
in Figure 5.5-3. In this figure the user is shown 
viewing the Picture Display from a distance of 
approximately 20 inches with a viewport width 
specified as the entire Picture Display (10 inches). 
From this it may be seen that the user should specify 
a window which has a responding ratio: 


IWR-LWL actual viewport width 


IWH-IE distance of viewer from Picture Display 


\ \ / of 


/ SCOPE FACE 
\ \ i. a 


bi MIEN EQRT IWL = -1000 
CU LRILZNEIZLA i ee 
| IWY = @ (5000) 
; Ps IE = 1000 
HITHER CLIPPING iwT | 


_ PLANE 


EYE a’ : 
POSITION ; } 
1E 


Figure 5.5-3 


Window Specification which creates a "proper" 
perspective for the actual position of the viewer 


LWR-LWL IWT-IWB 10" 


1 
IWH-LE IWH-IE 2 20" 


The statezents used to specify such a window are shown 
in Example 5.5-4. 


aagqaagaaaaaan 


AA. 


ASSUME A VIEWPORT OF 10 INCHES IN WIDTH AND 

HEIGHT, WITH THE USER EYE POSITION AT APPROXIMATELY 
20 INCHES FROM THE DISPLAY. THIS PRODUCES A VIEWING 
ANGLE OF ABOUT 28 DEGREES, AN ANGLE COMPARABLE TO 
THAT OF A CAMERA. SPECIFY THE WINDOW SO THAT: 


NOW 


IWR-IWL .IWT-IWB 1 


wwneeerese = ecos2eeces = =- 


IWH-IE IWH-IE 2 


(CALL VWPORT (-2048,2047,-2048 ,2047,255,0) 
‘CALL WINDOW (-1000, 1000,-1000, 1000, 5000,5000, 1000) 


PERFORM THE TRANSFORMATIONS 


~ CALL PUSH 


CALL TRAN (ITX, ITY, 172) 


- Bxample 525-4 
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. 5. 5.5 Sectioning 


For most applications it is desirable not to have a 
rear limit to the enclosure (i.e. it is desirable to 
have the yon clipping plane at infinity). Since 

e infinity is not an expressable value, a convention has 
been adopted which entails setting IWY equal to IWH, 
as in Example 5.5-4, to achieve the effect of a yon 
clipping plane at infinity. 


However, in some applications it is desirable to 
present the data to the viewer in a thin slice seen 
face-on. This is known as sectioning and is achieved 
simply by setting IWY to a value slightly beyond IwH. 
The section thickness may be gradually increased or 
decreased by advancing IWY steadily away from or 
toward IWH from frame to frame. It should be noted, 
however, that when IWY actually reaches IWH, the 
condition mentioned above will have occurred and 
because IWH = IWY¥, the yon clipping plane will be at 
infinity. This visually annoying situation may be 
easily avoided by choosing an increment for IWY which 
is not an even divisor of the section width (e.g. Iwy- 
IWH=250, but IWY=-20). Then the section width, as it 
decreases, will pass in steps through zero without 
actually landing on it, and the above difficulty is 
thus avoided. : 


| 5.5.6 Depth-cueing | 
' To complete the illusion of perspective, the intensity 
of the lines drawn may be diminished with distance 


from the eye. This feature is known as depth-cueing. 
This may be accomplished by setting the viewport 
hither and yon intensities at high and low values, 
respectively. The maximum depth-cue values are shown 
in the viewport specification of Example 5.5-5, as 
full intensity for IHI and no intensity (or black) for 
IYI. 


Cc 
Cc SPECIFY MAXIMUM DEPTH-CUEING 
Cc 

CALL VWPORT (-2000,2000,-2000,2000,255,0) 


Example 5.5-5 


@ 0 


For some viewers, however, these values tend to be a 
little harsh and a small but non-zero value for IY, 
permitting objects at apparently great distances to 
remain slightly visable, may be used. 


Both sectioning an d depth-cueing are permissible in 
orthographic as well as perspective views. However, 
when using sectioning and depth-cueing together in an 
orthographic view, it should be noted that line 
intensity decreases linearly through the section; 
whereas, in a perspective view intensity is adjusted 
such that the total. light emitted by a given line 
varies with apparent distance according to the 
inverse-square law of optics. This PICTURE SYSTEM 
feature allows data to be displayed as it wculd appear 
when illuminated by a light source; thereby allowing 
data to decrease rapidly in intensity with increase in 
apparent distance. ; 


Rear-facing Views 


For the sake of simplicity, all perspective and 
orthographic views produced by the WINDOW subroutine 
are oriented so that the viewer looks in the direction | 


-----Of positive Z-values. —To alter this view, the user 


merely has to provide the appropriate rotation and 
translation transformations by making appropriate 
calls to the ROT and TRAN subroutines. Assuming that 
north lies along the Z-axis with the Y-axis pointing 
up « a perspective view of the world looking northeast 
from a point 100 units east along the X-axis is 
generated by the statements shown in Example 5.5-6. 


However, due to the fact that values of IE may be 
specified which are greater than corresponding values 
of IWH, perspective views may be produced, without the 
aid of transformations, which look "south". In these 
views, the parameters IWL and IWR are automatically 
interchanged, so that the view appears as though the 
viewer had actually turned around and looked "south", 
rather than having obtained a "southern" view by 
looking "northward" through a mirror, as shown in 
Example 5.5-7. Thus, the effect obtained is exactly 
the same as if a northern view had been rotated 180 
degrees by a call to the ROT subroutine shown in 
Example 5.5-8. ; 
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AQAAANAANA 


ana 


AaAaAaAN 


VIEW LOOKING NORTHEAST FROM A POINT 100 UNITS 
EAST OF THE ORIGIN. HITHER CLIPPING PLANE IS 
400 UNITS AWAY, YON PLANE IS 5000 UNITS AWAY. 
(THE VIEWPORT IS MODIFIED BY ROTATING AND 
TRANSLATING THE DATA IN THE OPPOSITE DIRECTION.) 


CALL WINDOW (-100, 100,-100, 100,400 ,5000,0) 
IROT45=-8192 

TYAXIS=2 

CALL ROT (IROT45,IYAXIS) 

CALL TRAN(-100,0, 0) 


. 


Example 5.5-6 


_ VIEW WITH SOUTHERN EXPOSURE, WITHOUT TRANSFORMATIONS 


CALL WINDOW (-100, 100,-100, 100,-400,-5000,0) _ 


Example 5.5-7 


VIEW WITH "SOUTHERN" EXPOSURE, BY A ROTATION 
TRANSFORMATION 


CALL WINDOW (-100, 100,-100, 100,400 ,5000,0) 
IR 180=-32767 

TYAXIS=2 

CALL ROT (IB180,IYAXIS) 


Example 5.5-8 
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Placement of the Hither and Yon Planes 


For two-dimensional windowing, the hither plane is 
placed at z=0 and the yon plane at IW (normally 
32767). Thus transformed data with a negative z 
coordinate will be clipped at the hither clipping 
plane. For three-dimensional windowing (orthographic 
OL perspective), the placement of the hither and _ yon 
planes is explicitly specified by the arguments in the 
window call. By convention if IWH=IWY, then the yon 
plane will be placed at infinity on the side of hither 
plane opposite the eye position. If IWH¥IWY then the 
hither and yon planes will be placed at the positions 
Specified. However, to maintain utmost precision of 
transformed data, the hither and yon planes should not 
be given unnecessarily extreme positions; e.g., the 
hither plan e should ordinarily not be placed 
immediately in front of the eye. Maximal precision is 
maintained . “af the. distance between the hither and yon 
planes is in the Same order of magnitude as the width 
and hetones of. the hither PBsenSs 


ROTATION [ ROT ] 


A rotation transformation is applied to coordinate 
data using the ROT subroutine to cause a rotation of 
subsequent data drawn about an axis through the origin 
of the data space. Thus, if an object is described 
about the origin of the data space, a rotation 
transformation will rotate the object about its 
origin. However, if an object is not described about 
the origin of its data space, then a rotation 
transformation will rotate the object about the origin 
of the data space. The effect would be that of 
Swinging the object on a string rather than tumbling 
it. In order to rotate such as object about its own 
origin, it would first need to be translated to the 
origin of the data space then rotated and finally 
translated back to the position it occupied in the 
data space. 


The following is the ROT £calling sequence 
specification of Section 4.1: 


CALL ROT (IANGLE,IAXIS) oe 


The parameters passed to this subroutine specify the 


‘angle of rotation (IANGLE) to be applied and the axis 


(IAXIS) about which the rotation will be performed. 
The angle of rotation is given by dividing a circle 
into 216 egual parts, with zero being equal to zero 


degree and -215 equaling 180 degrees. This method 
allows a greater amount of precision for rotational 
values since: ~ , 


182.04 = 182 increments/degree 
3.03 = 3 increments/ninute 


32767/180 
182.04/60 


This allows rotations to be performed to a greater 


precision without the need for special floating-point 
hardware or increased execution time due to software 
floating-point calculations. 


Table 5.6-1 shows some common angles and their 
corresponding IANGLE values. Example 5.671 
illustrates the continuous rotation of an object about 
all three axes. It should be noted that a new 
rotation transformation for each axis is computed for. 
each frame update and these new rotation 
transformations represent the entire rotation about 
each axis rather than an incremental rotation for each 
axis. This technique prevents rotational roundoff 
error due to sequential matrix concatenations. 


o=73 


Rotation of data through a positive ang 
counter-clockwise when viewed along the. 
axis in the positive direction in the left-hand 
coordinate systen. 


5-74 


Table 5.6-1 


Angie 


300 

450 

60° 

900 

1800 

270° (-90°) 
3159 (-450) 
3609{ 0°) 


5-75 


or -32767 


ONE DEGREE 
DATA I/182/ 


INITIALIZE THE PICTURE SYSTEM 


aaAaAANn A 


CALL PSINIT(3,0,¢¢7) 
‘CALL SETERR(3,-1) 

IANGLX 
IANGLY 
IANGLZ 


Wow i 
° 


PERFORM THE PERSPECTIVE TRANSFORMATION 


aaAA 


CALL WINDOW(-10000, 10000,-10000,-10000,-10000,-10000) 


BEGIN THE DISPLAY LOOP BY UPDATING THE "ANGLES" 


-090aN 


00 IANGLX 
IANGLY 
IANGLZ 


IANGLX + I 
IANGLY + I 
IANGLZ + I 


SAVE THE ORIGINAL TRANSFORMATION 


aan 


CALL PUSH - 


ROTATE ABOUT THE Z AXIS 


aan 


--—-CALL ROT(IANGLZ,3) — 


ROTATE ABOUT Y AXIS 


aan 


CALL ROT (IANGLY, 2) 


ROTATE ABOUT THE X AXIS 


aaAN 


CALL ROT (IANGLX, 1) 


CALL A SUBROUTINE TO DISPLAY THE OBJECT 


aan 


CALL OBJECT 


RESTORE THE ORIGINAL TRANSFORMATION 


aaa 


CALL POP 

CALL NUFRAM 

GO TO 100 
END 


Example 5.6-1 
Note: The SETERR subroutine is used to avoid FORTRAN error 
detection of the integer overflow caused by this example. 
The call of the example is for DOS/BATCH FORTRAN. 


aa. 


TRANSLATION [TRAN] 


A translation transformation is applied to coordinate 
data, using the TRAN subroutine, to cause a 
translation of all subsequent data drawn in the X, Y 
and Z directions of the data space. The following is 
the TRAN calling sequence specification of Section 
4.13 


CALL TRAN(ITX,ITY,ITZ[,IW ]}) 


The parameters passed to this subroutine specify the x 
(ITX), Y (ITY) and Z (ITZ) translational values. 


Translation is often performed after an object has 
been rotated about its origin. However, in terms of 
coding an applications program, this means that the 
TRAN subroutine should be called before the ROT 
subroutine?, This order is illustrated by Example 
5.7-1 


NOW PERFORM THE TRANSFORMATIONS 
CALL TRAN (ITX,ITY,ITZ) 
CALL ROT (IANGLZ, 3) 
CALL ROT(IANGLY, 2) 
CALL ROT(IANGLX, 1) 
Cc 
C AND DISPLAY THE OBJECT 
Cc 


CALL DRAW3D, (IDATA, INUM,IF1,IF2) 


Example 5.7-1. 


1See Section 5.2.3 for a further discussion of the placement 


of CALLS. 


/ 


aAagaananna 


If it is necessary ‘to translate an object. to a 


position in the data space which is outside the range 
of values which can be expressed by a 16-bit number 
(+225-1), the optional argument [IW] may be used. 
This argument may be used to increase the effective 
range of the translational values to +239, 


Example 5.7-2 illustrates the calling sequence 
required to translate an object by 100000 in the X, Y 
and Z directions. 


_ TRANSLATE THE OBJECT BY 100000 IW X,¥ AND Z 
"BPPECTIVELY: _ CALL maw (100000, 100000, 100000) 


35000 = 10000074. i 
(8192 = 3276774 


CALL. “TRAN (25000, 25000, 25000, 8192), 


Example 5.7-2 
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SCALING [ SCALE] 


A scaling transformation is applied to coordinate 
data, using the SCALE subroutine, to cause an increase 
or decrease in the size of subsequent data drawn. The 
following is the SCALE cans sequence specification 
of Section 4.1: 


CALL SCALE(ISX,ISY,ISZ[ ,1IW]) 


The parameters passed to the subroutine specify the Xx 
(ISX), Y (IS¥Y) and 2Z (ISZ) scaling values. The 
scaling values are integers which specify the number 
of 1/32767 by which coordinate data is to scaled. For 
example if an object were to be decreased in size by 
1/2 in the X, ¥Y and Z2 axes then the appropriate 
scaling values would be: 
ISX = ISY = ISZ = 1/2°32767 = 16384 


and the following calling sequence would be used: 


CALL SCALE (16384,16384, 16384) 


If ISX = ISY = ISZ = 32767 then the coordinate data. 
would ‘remain unscaled.. 


If an object is to be increased in size larger than 
its definition in the data space, the homogeneous 


-coordinate IW is used as described in Section 5.8-3. 


Data Distortion 


If the scaling values ISX, ISY and ISZ are not equal, 


- they have the effect of distorting pictures by 


elongating or shrinking them along the directions 
parallel to the coordinate axes. This may be used to 
emphasize certain structural characteristics of the 
data displayed. It should be noted that if the 
scaling is to be always parallel to the X, Y and Z 
axes of the object, the scaling should be performed 
before the object has been rotated about its origin. 
This means that the SCALE subroutine should be called 
after the ROT subroutine!, This order is illustrated 
by Example 5.8-1. 


TSee Section 5.2.3 for a further discussion of the placement of 


CALLs. 


5. 8.2 


NOW PERFORM THE TRANSFORMATIONS 


ana 


CALL TRAN (ITX, ITY, ITZ) 
CALL ROT (IANGLZ, 3) 

CALL ROT(IANGLY, 2) 

CALL ROT (IANGLX, 1) 

CALL SCALE (ISX,ISY,1ISZ) 


Cc . 
Cc NOW DISPLAY THE OBJECTS 
Cc ae 
CALL DRAW3D (IDATA, INUM,IF1,IF2) 
Example 5.8-1 
Mirroring 


The mirror image of an object may be generated by 
using negative values for ISX, ISY or ISZ With this 
ability, an object which is symetrical along an axis 
or axes may be described as a half or quarter image 
and mirrored to produce a full image for display. 
Typical mirroring calling sequences are shown in 
Example 5.8-2. : ' 


5. 8.3 


MIRROR DATA ABOUT THE X-AXIS 


ana 


CALL PUSH 
CALL SCALE (-32767, 32767, 32767) 


CALL POP 
Cc 
Cc MIRROR DATA ABOUT THE Y-AXIS 
Cc 
CALL PUSH 
CALL SCALE (32767,-32767, 32767) 
CALL POP 
Cc 
c MIRROR DATA ABOUT THE Z-AXIS 
Cc 


CALL PUSH 
CALL SCALE (32767, 32767 32767) 


CALL POP - . os 8 eee — 


Example 5. 8-2 


Scaling Using the Homogeneous Coordinate, Iw 


Coordinate data may be decreased in size by specifying 
scaling values for ISK, ISY and ISZ less than 32767 as 
described in Section 5.8. However, a corresponding 
increase in size may not be done if ISX=1SY=15Z=32767 
unless the homogeneous coordinate, IW is utilized. As 
IW is decreased from the value 32767, the effective 
range of the scaling values ISX, ISY and I8Z is 
increased to +239, 


Exauple 5.8-4 illustrates the calling sequence 
required to scale data to twice its size. 


NOW SCALE THE DATA TO TWICE ITS SIZE 
EFFECTIVELY: CALL SCALE (65534,65534, 65534) 
32767 = 65534/2 

16384 = 32767/2 


AAAAAA 


CALL SCALE (32767,32767,32767, 16384) 


Example 5. 8-4 


DATA DISPLAY 


Data that is displayed on THE PICTURE SYSTEM may 
consist of three data types: 


1. Lines and dots 
2. Characters 
3. Instances 


Of these three data types, the first two may be 
considered the primitives from which the third is 
constructed. The user is free to utilize each of the 
data types available without regard for the mixing of 
the data types and constrained only by the length of 
the Refresh Buffer and the frame update rate required 
to provide the dynamic motion of the data displayed. 
The following sections describe the use of the 
subroutines contained in the Graphics Software Package 
which allow the display of each of these data types. 


Display of Lines and Dots [ DRAW2D,DRAW3D] 


The display of two-_or three-dimensional data sets as 
lines or dots is accomplished by calling the DRAW2D or 
DRAW3D subroutines. The following are the DRAW2D and 
DRAW3D calling sequence mpeCiEtcat tone of Section 4.1: 


CALL DRAW2D(IDATA, NUM, IF1, IF2,12Z[ ,IW}) 
“—~ CALL DRAW3D (IDATA,NUM,IF1,1F2[ ,IW]) 


These subroutines are very general; the user specifies 
using the IF1 parameter, the type of draw function to 
be performed (i.e. disjoint lines, connected lines, 
dots) and using IF2 parameter, the mode in which the 
X,Y or x,y,z coordinates are to be interpreted (i.e. 
absolute, relative, absolute-relative). The valid 
values for IF1 are: 


Disjoint lines from new position. 
Disjoint lines from current position. 
Connected lines from new position. 
Connected lines from current position. 
Dot at each point. 


Whe Oo 
nouw wea 


The valid values for IF2 are: 


absolute-relative- ~relative- -relative-etc. 
relative always. 
absolute always. 


holt ow 


0 
1 
2 
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5.96161 


The DRAW2D and DRAW3D subroutines may display the sa 


set in a variety of ways dependent upon the values “of 


the IF and IF2 parameters at the time of the call: 


To illustrate this, Figure 5.9-1 shows the simplistic » 


data set: 
X1,Y1 = 1,0 
X2,X2 = -1,-2 
X3,Y¥3 = 1,-2 
xX4,y¥4 = 1,0 
X5,Y5 = 3,2 


as it would be displayed for each of the valid vatiee 
of IF1i and IF2 on a grid which ranges from —~4 to 4, 


It is assumed for each of these drawings that the 
current position before the draw begins is at the x,y 
= 0,1 4xposition. The user is free to utilize these 
drawing functions in whatever manner is required by 
his particular application. The decision to use a 
two-dimensional or three-dimensional data set is 
dependent upon the data, but the ability to display a 
two-dimensional data set -within a three-dimensional 
environment is available to the user... 


Drawing Two-Dimensional Data 


Two-dimensional data is defined within a data set as a. 


series of x,y coordinates with constant z and w 
coordinates for the entire data set. Thus, two- 


dimensional data is really three-dimensional data 


which resides in a constant plane and may therefore be 
ROTated, TRANslated, etc. as a three-dimensional data 
set. Example 5.9-1 shows a typical call to the DRAW2D 
subroutine to draw the data set IDATA, which contains 
five data points, as connected lines from the first 
data point with all coordinate data interpreted das 
atsolute coordinates. The entire data set will be 
drawn as if it resides in the Z = 16384 plane. 


Cc 


INTEGER IDATA (2, 5) 
DATA IDATA/10000,10000,- 10000, 10000,-10000,-1000: 
1 10000,-10000,10000,10000/ 


NOW DRAW THE 2D DATA 


CALL DRAW2D(IDATA,5,2, 2, 16384) 


Example 5.9-1 


i@ 

DISJOINT LINES | ROM NEW POSITION 
Ir2«g 

ABPSOLUT E - RELATIVE ~ RELATIVE - ECT. 


Fist 

oon LINES FROM CURRENT POSITION 
IF2= 2 

ABSOLUTE -RELATIVE-RELATIVE-ECT. 


IFix2 

oe iad LINES FROM NEW POSITION 
If2= z : 
ABSOLUTE - RELATIVE-RELATIVE - €cT. 


IFis 3 é a , 
CONNECTED LINES FROM CURRENT POSITION 
ABSOLUTE - RELATIVE -RELATIVE-ECT. 


IF1=4 : 

a4 ial SPECIFIED POINTS 

IF2+0 

ABSOLUTE ~ RELATIVE-RELATIVE- ECT. 


IFLe@ 

DI4JOINT LINES FROM NEW POSITION 
Ip2et 

RELATIVE ALWAYS 


IFizt 

DISJOINT LINES FROM CURRENT POSITION 
IF2=\ 

RELATIVE ALWAYS 


IF{=2 

CONNECTED LINES FROM NEW POSITION 
IF2=\ 

RELATIVE ALWAYS 


1FL=3 ; ae ; 
CONNECTED LINES FROM. CURRENT POSITION 


IF2=! . 
RELATIVE ALWAYS 


IFi=4 ; 
rae AT SPECIFIED POINTS 

F2=1 ans : 
RELATIVE ALWAYS 


FIGURE %.9-1 
THE DRAWING FUNCTIONS OF THE DRAWZD AND DRAW3D SUBROUTINES 
NOTE: A SETPOINT IS INDICATED BY THE O SYMBOL. 
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trie 

DISJOINT LINES FROM NEW POSITION 
F272 

ABSOLUTE ALWAYS 


IFi=1 

DISJOINT LINES FROM CURRENT FOSITION 
IFZ2=2 

ABSOLUTE ALWAYS 


IFizZ 

CONNECTED LINES FROMNEW POSITION 
1F232 

ABSOLUTE ALWAYS 


CONNECTED LINES FROM CURRENT POSITION 


1©2=*2 


ABSOLUTE ALWAYS 


IFI=4 : 

DOTS AT SPECIFIED POINTS 
IFZ=2 

ABSOLUTE ALWAYS 


When the DRAW2D subroutine is used to draw two- 
dimensional data, the constant z coordinate (IZ) is 
used to specify the intensity at which the image is to 
be displayed1. When viewed through a two-dimensional 
window, IZ = 0 will cause the data to be displayed at 
the maximum intensity2 as specified in the call to the 
V¥PORT subroutine. To decrease the intensity of the 
data displayed through such a window, the user need 
only adjust the value of IZ to be more positive. In 
two-dimensional windowing, the intensity of the data 
displayed decreases linearly as IZ = 0- %32767 with 256 
distinct levels of intensity available for user 
specification. Once the intensity level which is 
required by the user is determined, the value of IZ 
may be directly computed by the ratio: 


IH is the hither intensity in the viewport specif- 


cation. 
Iy is the yon intensity in the viewport speci fica- 
' tion. 
IL is the intensity level required by the user. 
(IH2IL2IY) 


Eo as si .From this ratio, it can be seen that to display two- 
a “oo  -* -@imensional;data at an intensity level which -is -one 

, : half the maximum (128), a call such as that shown in 
Example 5.9-2 would be required. 


ifhis assumes that a viewport was specified which allows inten- 
sity variation (i.e. depth-cueing). 


2fThis is because the data is drawn in the same Z plane as the 
hither clipping plane, which is positioned at Z = 0 for two- 
dimensional windowing. 


 -aaAaAA 


QAANAANAAN 


SET FOR DEPTH-CUEING AND 2D WINDOWING 


CALL VWPORT (-2047,2047, -2047, 2047 ,255,0) 
CALL WINDOW (- 10000, 10000, -10000, 10000) 


NOW DRAW THE DATA AT HALF INTENSITY (LEVEL 128) 
255 - 128 127 1 IZ 


= ----- THEREFORE IZ = 16384 
255 - 0 255 2 32767 


CALL DRAW2D (IDATA,N,2,2, 16384) 


Example 5.9-2 


5696182 Drawing Three~Dimensional Data 


Three-dimensional data is defined within a data set as 
a series of x,y coordinates with a constant (or 
default) w coordinate. Example 5.9-3 shows a typical 
call to the DRAW3D subroutine to draw the data set 
IDATA, which contains five data points, as connected 
lines from the first data point with all coordinate 
data interpreted as absolute coordinates. 


INTEGER IDATA (3,5) 
DATA IDATA/10000, 10000, 16384,-10000,10000, 16384, 
1 -10000,-10000, 16384, 10000,-10000, 16384, 10000, 10000, 
1 16384/ 


CALL DRAW3D(IDATA,5, 2,2) 
Example 5.9-3} 


IThis example is equivalent to the two-dimensional case of Example 5.9- 
and would produce the same image if displayed. 
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When the DRAW3D subroutine is used to draw three- 

dimensional data, the z-position of the transformed 

data in relation to the hither and yon clipping planes 

determines the intensity at which the data is 

displayed. When viewed orthographically, the 

intensity at which the data is displayed varies. 
linearly from the hither to yon clipping planes. When 

viewed in perspective, however, the intensity at which 

the data is displayed varies reciprocally from the 

hither to yon clipping planes. 


5.9.1.3 Specific Drawing Functions 


The DRAW2D and DRAW3D subroutines allow the user to 
draw data in many nodes. Often however, the user 
needs only a specific drawing mode (i.e. needs to draw 
only one line or may only need to position to a given 
point). In cases such as these, the four, five or six 
parameters of these subroutines calls seem overly 
complicated. In these cases the user may create 
subroutines of ‘his own, which in turn call the DRAW2D 
and DRAW3D subroutines, to perform a specific type of 
draw function.» Examples 5.9-4 and 5.9-5 show how this 
may .be done to. provide the two-dimensional "move to" 
{absolute) | Ot meer", (reeor ers) functions. 


eae et ee eee ome 


’This assumes that a viewport was specified which allows intensity 
variation (i.e. depth-cueing) . 


AAQANAANAANAAAAANN 


SUBROUTINE MOVETO (IX,IY) 


THIS SUBROUTINE PROVIDES THE ABILITY TO "MOVE TO" A GIVEN X,Y 
POSITION BY SPECIFYING ONLY THE X,Y COORDINATES. 


CALLING SEQUENCE: 


CALL MOVETO(IX,IY) 


WHERES 
IX IS AN INTEGER WHICH SPECIFIES THE X COORDINATE 
IY IS AN INTEGER WHICH SPECIFIES THE Y COORDINATE 


INTEGER IDATA (2) 
IDATA (1) =IX 
IDATA (2) =1Y 
CALL DRAW2D(IDATA, 1,2,2,9) 
RETURN 
END 
Example 5.9-4 


‘SUBROUTINE MOVE (IX, IY) 
THIS SUBROUTINE PROVIDES THE ABILITY TO "MOVE" A GIVEN DELTA + 


AND DELTA Y BY SPECIFYING ONLY THE X AND Y RELATIVE VALUES. 


CALLING SEQUENCE: 


! 
i 


ananNnaNnANAANANA 


CALL MOVE (IDX,IDY) 


WHERE: 
IDX IS AN INTEGER WHICH SPECIFIES THE DELTA X VALUE. 
IDY IS AN INTEGER WHICH SPECIFIES THE DELTA Y VALUE. 


INTEGER IDATA (2) 
IDATA (1) =IDX 

IDATA (2) =IDY 

CALL DRAW2D(IDATA, 1,2, 1,0) 
RETURN 

END» 


Example 5.9-5 


This technique, of course, may be used in conjunction 
with any of the general purpose subroutines of the 
Graphics Software Package to provide for PICTURE 
SYSTEM compatibility with existing graphics 
applications or to facilitate the development of a 
device-independent graphics "language". 


5.9.2 Display of Characters 


The display of characters, represented within the 
Picture Controller as an ASCII text string, is 
accomplished bys: 


1. Calling the CHAR subroutine to specify the 
size and orientation in which the characters 
are to appear. 

2. Calling the DRAW2D and DRAW3D subroutine to 
move to the position to where the text is to 
be displayed. 

3. Calling the TEXT subroutine to output the char- 
acters to be displayed. , 


The following are the CHAR and TEXT calling sequence spec- 
ifications of Section 4.1: 


CALL CHAR (IXSIZE,IYSIZE,ITILT) 


CALL TEXT (NCHARS, ITEXT) 


5.9.2. 1 Character Size and Orientation [CHAR] 


The CHAR subroutine may specify a total of 64% 
character sizes and 2 orientations for text display. 
fypically though, the xX and Y character sizes are 
equal (or nearly egual; +1 or 2) so that the 
characters do not appear extremely flat or thin. The 
character sizes available are shown in Figure 5.9-2. 
As this figure illustrates, the sizes may range fron 
0.07 inches to 0.56 inches. The characters which are 
displayed may be oriented either horizontally or 
vertically depending on the value of the ITILT 
parameter as shown in Figure 5.9-3a and b. The CHAR 
subroutine may be called at any time during the 
execution of the user's program and the character size 
and orientation will remain in effect throughout the 
duration of the program or until a subsequent call to 
the CHAR subroutine. Therefore, if the default 
character specification (horizontal 0.28 characters) 
is sufficient for the user's application, the CHAR 
subroutine need not be called at all. It should be 
noted, however, that character size and orientation 


changes applied halfway through a given frame will 

still be in effect at the beginning of the next frame, 

and thus the default values may no longer be relied 
on, but must be explicitly specified. 


#, ty *y =M =M=M =M = 
| | | | 


07 14) Qt 28 : 35 42 49 56 


Figure 5.9-2 


Standard Character Sizes in Inches. 


HORIZONTAL 
Figure 5.9-3a 


Horizontal Character Orientation (ITILT=0) 


VERTICAL 


Figure 5.9-3b 


Vertical Character Orientation (ITILT#Z0) 


5292222 Positioning for Text Display 


Text is positioned for display within a two- or three- 
dimensional environment by calling the DRBAW2D or 
DRAW3D subroutine to perform a move to an x,y (or 
XeY,Z) position or to draw a data set whose last point 
is the position from which the text string is to be 
displayed. This position will be at the lower left 
corner of the first character drawn. The intensity of 
the move (or of the last line drawn) determines’ the 
intensity at which all of the subsequent characters 
.drawn are displayed. Hence, characters may be 
displayed at any of the 256 levels of intensity. 
Typically though, characters are displayed at the 
Maximum intensity available and a two-dimensional 
window is used to make positioning and intensity 


specification Simple. A natural two-dimensional 
window to use is the one which is initialized when 


PSINIT is called. This window! is one whose 
boundaries are: 2a / 
cee window left boundary: - 32767 
. window right boundary: 32767 
_window bottom boundary’ -32767 


window top boundary: 32767 
hither boundary: ¢) 
yon boundary: 32767 


The user then, is free to position anywhere within 
this window and to define the intensity at which the 
text string will be displayed (Iz=0 for maximum 
intensity). To ensure that this window is always 
available to be used for text positioning, the user 
should PUSH it before any transformations are 
performed and POP back to it before the next frame is 
to be created. Example 5.9-6 shows how this may be 
done. 


The user should note that the viewport in effect at 
the time the text is positioned for display will 
determine the position on the screen where the text 
will be displayed. For example, if the viewport in 


This two-dimensional window is merely an identity matrix. 
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INTEGER IDATA (2) 
DATA IDATA/-32767,0/ 


INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT(3,05s.4¢) 
BEGIN THE DISPLAY LOOP BY SAVING THE IDENTITY MATRIX 
CALL PUSH 
CALL VW@PORT (~2048,2047,-2048, 2047, 255, 255) 
CALL DRAW2D(IDATA,1,2,2,0) 
CALL TEXT(18,'THE PICTUE SYSTEM‘) 
SET THE VIEWPORT AND POINT OF VIEW 


CALL VWPORT (0,2047,-2048,0,255,50) 
CALL WINDOW (-1000,1000, -1000, 1000 ,- 1000,5000,-5000) 


AND SAVE THE POLNT OF VIEW 


CALL PUSH _ | Ss 


NOW THE TRANSFORMATIONS 


CALL BOT (16384,1) 


s . oes meee - 


CALL POP 
DISPLAY THE NEW FRAME 
CALL NUFRAN 
RESTORE THE IDENTITY AND CONTINUE 
CALL POP 
GO TO 100 


Example 5. 9-6 
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effect at the time the text is positioned is the lover 
right quadrant of the screen, then po x,y coordinate 
pair could position text for display in any of the 
other quadrants of the screen. For this reason, text. 
is typically displayed within a viewport whose 
boundaries are the maximum boundaries of the screen. 
The user should also note that since the characters 
are stored in the Refresh Buffer as packed ASCII codes 
and generated relative to the last character 
displayed, they are not passed through the clipping 
process of the Picture Processor and hence, are not 
clipped at viewport or screen boundaries. If the user 
attempts to display more character s than may fit 
within a viewport, the string will extend out into the 
neighboring area and if the text string extends out to 
(and past) the screen boundary, the characters will 
"wrap-around" to the opposite side of the screen where 
they will continu2 to be displayed. A similar warning 
should be issued for the positioning of the text. If 
the point or line which positions the text is clipped 
by the Picture. Processor, the text string will be 
displayed positioned from the last x,y coordinates 
which were placed into the Refresh Buffer. This may. 
lead to confusion for users who are unaware of the 
cause, | 


_ Text Output [ TEXT] 


Text is output for display on THE PICTURE SYSTEM by 
calling the TEXT subroutine specifying the number of 
characters to be displayed and an ASCII text string 
which contains the characters to be displayed, as 
shown in Example 5.9-7. . 


CALL TEXT (18,"THE PICTURE SYSTEM") 


Example 5.9-7 , 


This will cause the ASCII character string "THE 
PICTURE SYSTEM" to be displayed at the position and 
intensity last specified by a call to the DRAW2D or 
DRAW3D subroutine (or positioned by previous text 
display) and at the size last specified in a call to 
the CHAR subroutine or initialized by PSINIT. 


All text is output to the Refresh Buffer as ASCII 
character codes. The 96 characters which may be 


~ 


displayed are shown, along their ASCII codes, in Table 
5.9-1. When these codes are encountered in the 
Refresh Buffer during the refresh cycle, the 
Character Generator is called to stroke the character 
encountered relative to the current position of the 
beam on the scope. 


A character is always stroked (in horizontal or 
vertical mode) relative to the lower left position of 
the area in which any given character is defined. 
Figures 5.9-4a and b show the area in which a 
character is displayed by the Character Generator. 
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Figure 5.9-4a 
Horizontal Character Stroking Relative to the Current 
Position of the Bean. 


Figure 5.9-4b 
Vertical Character Stroking Relative to the Current 
Position of the Bean. 
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5. 9.3 
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Instancing [ INST, MASTER ] 


As was pointed out previously, the data which 
comprises a scene is made up of a series of 
primitives, i.e. lines, dots and strings of text. 
These primitives are used, either singly or 
repeatedly, to generate objects which comprise a scene 
to be viewed. The ability to create a easily position 
more conplex primitives greatly simplifies 
construction of a scene. For example, suppose a 
transistor symbol is defined as a primitive. Then, in 
order to construct a complicated schematic diagram 
containing several transistors, the user need only 
specify the position, size and orientation of every 
occurrence of the transistor symbol and display of the 
symbol is then automatic for each occurrence. The 
technique of constructing and positioning complex 
primitives such as these, and generating repeated 
copies thereof, is called instancing. It constitutes 
one of the more powerful toools of computer gqraphics. 


An instance of a given primitive is invoked using the 
qraphics software by: 


1. Calling the INST subroutine to define the 
boundaries within which the instance is to be 
placed. These boundaries define the position 
of the instance within the data space and, 
typically, also within the WINDOW. If the 
instance boundaries are outside of the window 
boundaries, the instance will be totally clipped; 
if the instance boundaries are partially inside 
the window boundaries, only that portion of the 
instance which lies within the window will be 
displayed; if the instance boundaries are within 
the window, the entire instance will be displayed. 


2. Calling the ROT subroutine one or nore times 
if the instance is to appear in an orientation 
which is different from that in which the original 
primitive was defined (i.e. if a symbol is to 
appear rotated 90° from its original position, 
etc.). This call maybe omitted otherwise. 


3. Calling the subroutine which defines and outputs 
the given primitive. 
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The following is the INST calling sequence specifica- 
tion of Section 4.1: 


e CALL INST(INL,INR,INB,INT[ , IW 1) 
} or 
CALL INST (INL,INR,INB,INT,INH, INY{, Iw J) 


As described above, the INST parameters define the 
boundaries within which the instance is to be placed. 
If the instance is two-dimensional, INST is called 
with a four? argument parameter list such as that 
shown in Example 5.9-8. 


Cc 
Cc SET A TWO-DIMENSIONAL WINDOW 
Cc 
CALL WINDOW (0, 16000, 0,16000) 
Cc , 
Cc DISPLAY A TWO-DIMENSIONAL INSTANCE OF A HOUSE 
Cc 


CALL ‘INST (4000, 8000, 4000, 8000) 
' CALL HOUSE2 


Example 5.9-8 


If the instance is three-dimensional, INST is called 
with a Six? argument parameter list such as that shown 
in Example 5.9-3. 


iThe four argument parameter list may be extended to 
five arguments with the inclusion of the scale factor, 
IW. 

2The six argument parameter list may be extended to 
seven arguments with the inclusion of the scale factor, 
IW. 
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SET A THREE-~DIMENSIONAL WINDOW 


CALL WINDOW (0, 16000,0,16000,0,0, 32000) 


DISPLAY A THREE-DIMENSIONAL INSTANCE OF A HOUSE 


CALL INST(4000, 8000, 4000, 8000, 2000, 6000) 
CALL HOUSE3 


- Example 5.9-9 
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In the two previous examples, HOUSE2 and HOUSE3 are 
subroutines which define a graphic primitive . or 
“master copy". A “master copy" defines an object or 
- symbol which is to be instanced and takes the form of. 
a FORTRAN subroutine. A subroutine of this type 
always contains four parts which must be executed in 
the following order: 


a. A call to the graphics subroutine MASTER 
to set the boundaries of the data space 
within which the master copy will be 
defined. 

b. Calls to the various transformation and 
data output subroutines (ROT,TRAN, 
DRAW2D, etc.) which define the primitive. 

ce. A call-to the graphics subroutine POP. 

d..A FORTRAN RETURN statement. 


Example 5.9-10 shows the FORTRAN subroutine, HOUSE2 


referenced previously in Example 5.9-8, which contains 
these four parts. © 
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SUBROUTINE HOUSE2 : 
INTEGER HOUSE (2,6), DOOR (2,5) 


DEFINE THE TWO-DIMENSIONAL HOUSE DATA 


DATA HOUSE/0,32000, 32000, 16000, 32000,-32000, -32000,-32000, 
1 -32000, 16000, 0,32000/ 


AND A DOOR 


DATA DOOR/4000,46000,4000, -32000 ,-4000,-32000, 
1 -4000,-16000, 4000,-16000/ 


BEGIN THE TWO-DIMENSIONAL MASTER COPY 
CALL MASTER (-32767,32767,-32767, 32767) 
DRAW THE HOUSE 


CALL DRAW2D (HOUSE, 6, 22,0) 


AND THE POOR 


CALL DRAW2D{DOOR, 5, a oy 70). 
wow RESTORE THE ‘TRANSFORMATION MATRIX AND RETURN 
CALL POP = we ee ee ae 


RETURN 
END 


Example 5.9-10 
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The following discussion describes each of the parts, 
illustrated by Example 5.9-10 in more details: _ 


a. A call to the MASTER subroutine generates a 
Six-sided, box-shaped enclosure, similar to 
that produced by an orthographic call to the 
WINDOW subroutine (in fact the transformations 
produced by the two routines are exactly identi- 
cal). This enclosure is used as the definition 
space for the primitive. AS each instance 
of the primitive is invoked, the "master copy" 
is napped (subject to rotation) onto the 
instance enclosure (defined hereafter). Since 
all four (or six) boundaries of both enclosures 
are individually specifiable, the instance may 
therefore differ in size, shape and location 
from the master; however, the basic primitives 
comprising the instance bear the same spatial 
relationship to each other as do those of the : 
mMaster--in other words, a transistor still 
looks like a transistor, although its size 
and shape may be modified. The following are 
the MASTER subroutine calling sequence specifi- 
cations of Section 4.1: a3 


CALL MASTER (IML,IMR,IMB,IMT[ ,IW )) 
or , 
CALL MASTER (IML, IMR, IMB, IMT, IMH,IMY{ ,IW})~ 


The parameters define the left, right,-botton, 
top, hither and yon boundaries of the master 
enclosure in data space coordinates. For two- 
dimensional calls, the IMH and IMY parameters 
are omitted. The origin (and thus the center 
of rotation) of the master copy is at center 
of the front boundary of the master enclosure. 
NOTE: Each instance invoked produces two 
transformations, the master and the instance 
which are concatenated. Because instances 
tend to be small compared to the window 

in which they are viewed, this concatenated 
transformation may suffer a loss of pre- 
cision if the MASTER enclosure is not defined 
as large as possible. Therefore, a MASTER 
enclosure should not be defined more than an 
arder of magnitude smaller than the scaling 
parameter, IW (normally 32767). The data should 
also be defined so that it extends the full 
range of the master enclosure. 


b. The output comprising the primitive may consist 
of any executable FORTRAN statements and 
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qraphics subroutine calls, normally calls to 
the subroutines DRAW2D, DRAW3D, TEXT and the 
transformation subroutines ROT, TRAN and SCALE; 
as well as calls to other instancing subroutines. 
Thus, nested instances and even recursive calls 
to the same primitive definition subroutine are 
permitted, so long as a conditional exit is 
provided to prevent infinite recursion, and 
that sufficient Matrix Stack space is alloca- 
ted when calling the PSINIT Subroutine, since 
each instance call results in an implied PUSH. 
However, the loss of precision previously 
mentioned is compounded with each level of 
nesting. 


While the MASTER call transformation is identi- 

. cal to that of a WINDOW call, data is not 

f clipped at the master boundaries as it is at 

| the pornos e ee of a normal window; there- 
q ‘ beyond the master 


S54 - rovidéd 
extend beyond the bounds 


C. Each call.to a master copy subroutine is 
preceeded by a call to the INST subroutine 
which contains an implicit PUSH. In order to 
restore the original transformation for use 
following the instance, a call to the POP 
subroutine to restore that transformation must 
be performed. 


-@. The subroutine RETURN statement should 
immediately follow the POP call. Note that 
the master copy Subroutine may just as easily 
be coded in assembly language, provided that 
it meets the above specifications and that it 
is FORTRAN-callable (see Appendix C). 


Using this technique, two- and three-dimensional 
primitives may be defined and libraries of these 
"master copies" maintained. Example 5.9~-11 shows a 
simple program which uses the primitive defined by 
Example 5.-9-10. Figure 5.9-5 shows the mapping 
performed by THE PICTURE SYSTEM during instancing. 
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INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT (3,0¢4,5,) 
SET THE TWO-DIMENSIONAL WINDOW 
CALL WINDOW (0,16000,0,16000) 
DISPLAY THE FIRST INSTANCE OF THE HOUSE 


CALL INST (4000, 8000,4000,8000) 
CALL HOUSE2 


DISPLAY THE SECOND INSTANCE OF THE HOUSE 
(ROTATED -909) 


CALL INST(14000,18000,10000, 14000) 
CALL ROT (-16384,3) 
CALL HOUSE2 

DISPLAY THE DATA 


CALL’ NUFRAM — 
- PAUSE 


‘STOP © 
_ END 


Example 5.9-4 
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Figure 5.9-5 
Illustration of the Mapping of the Instances to the Window and 
the Window to the Viewport of Example 5.9-11 Showing (1) the master 
copy definition of Example 5.9-10, (2) ;the mapping of the master 
copy into two instance regions of the data space and (3) the Mapping of the 
Window to the Viewport. 
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5.94.2 


Display Modes 


All lines, dots, characters and instances may be 
displayed in dashed and/or blinking display mode. on 
one to four Picture Displays (or any combination 
thereof) simultaneously. The following sections 
describe how each of the display modes are initiated 
and the manner in which Picture Displays may be 
selected for output. It should be noted that once 
set, these display modes remain in effect until the 
mode is reset with a corresponding subroutine call. 


- Thus, a display may remain in effect for subsequent 


frames overriding the default setting and even 
affecting the cursor (which, if used, is output to the 
beginning of the Refresh Buffer). Therefore, if a 
user was employing blink mode, it should be reset 
before calling NUFRAM unless the cursor is intended to 
blink. 


Dashed Display Mode [DASH } 


When PSINIT is called to initialize THE PICTURE 
SYSTEM, the display mode is set so that all subsequent 
data output will be drawn in solid line mode. This 
mode will remain in effect until the user calls the 
DASH subroutine to initiate dashed line mode, The 
following is the DASH Goan Sequence specification 
of Section 4, AS, fee of 


CALL DASH({ISTAT) 


The parameter passed to this subroutine specifies the 
mode which all subsequent lines will be drawn in, 
until PSINIT is called to re-initialize the system or 
DASH is called to reset the line status. If DASH is 
called with ISTAT#¥0, all subsequent data output will 
be drawn in dashed line mode. Characters may also be 
displayed in dash modes but may appear 
indistinguishable because of the dashed lines. A call 
to DASH with ISTAT=0 resets solid line mode. Dots 
which are drawn in dashed display mode appear as dots. 


Blink Display Mode [BLINK } 


When PSINIT is called to initialize THE PICTURE SYSTEM 
the display mode is set so that all subsequent data 
output will be drawn in non-blink mode. This mode 
will remain in effect until the user calls the BLINK 
subroutine to initiate blink display wmode. The 
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following is the BLINK calling sequence specification ie 
of Section 4.1: 


CALL BLINK (ISTAT) 


The parameter passed to this subroutine specifies the 
mode which all subsequent lines will be drawn in, 
until PSINIT is called to re-initialize the system or 
BLINK is called to reset the display mode. If BLINK 
is called with ISTAT=0, all subsequent data output 
will be displayed non-blinking. If BLINK is called 
with ISTAT#0, all subsequent data output will be 
displayed blinking at the approximate rate of 90 
blinks per minute. . Example 5.9-10 shows how blink 
mode may be used to cause a blinking cursor to be 
displayed. 


Cc 
-C.. INITIALIZE THE PICTURE SYSTEM 
, CALL PSINIT (3,0, 0,7) 
ae CALL TABLET(1,IX,IY,IPEN) 
ve CALL CURSOR (IX, IY, 1 7 lPEN) 


“BEGIN THE DISPLAY LOOP, . RESET THE: BLINK MODE LEFT 


Cc 

Cc 
ee: FROM THE END OF THE DISPLAY ‘LOOP. 
“2€ Pie 

1 


“00s caLE BLINK (0) 


Cc. or ee eR 
Cc SET THE BLINK MODE FOR THE CURSOR 
Cc 

CA1ll1 BLINK (1) 
c 
c NEW FRAME 
Cc 


CALL NUFRAM 
GO TO 100 


Example 5.9-10 
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5.9.4.3 


Scope Selection [SCOPE] 


When PSINIT is called to initialize THE PICTURE 
SYSTEM, all Picture Displays (Scopes 1-4) are selected 
for output. This selection will remain in effect 
until the SCOPE subroutine is called to de-select the 
Picture Displays to which output is directed. The 
following is the SCOPE calling sequence specification 
of Section 4.1: 


CALL SCOPE (INUM) 


The parameter passed to this subroutine specifies the 
Picture Display to be selected (1-4). If INUM is less 
than 1 or greater than 4, all scopes will be de- 
selected and all subsequent data output will not be 
displayed until the SCOPE subroutine is called again 
to select a Picture Display. 


If the user's particular PICTURE SYSTEM configuration 
has less than four Picture Displays, the selection of 
all scopes for output incurs no additional overhead, 
but insures that output will be directed to the 
Picture Display(s),. regardless of the actual 
configuration of the components of the Picture 
Generator. — 
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5- 10.1 


INITIATING THE DISPLAY OF DATA [NUFRAM,SETBUF } 


The manner in which frames are displayed on THE 
PICTURE SYSTEM is dependent upon the environment in 
which the control program executes. The environments 
that are available are: 


1. The Refresh Buffer absent from the systen 


configuration. 

2. The Refresh Buffer used in single-buffer 
node. 

3. The Refresh Buffer used in double-buffer 
mode, 


In each of these environments, the basic progqtah 
structure is the same, and the only difference is the 
way in which the display of data is initiated. The 
following sections describe the display of data within 
each of these environments, | 


Display of Data Without a Refresh Buffer 

THE PICTURE SYSTEM may. be configured in what is known 
as a. Starter Configuration. This minimal 
configuration, shown in Figure 5.10-1, has all of the 
hardware processing features of the standard PICTURE 
SYSTEM, but. does not include a Refresh Buffer. The - 
absence of the Refresh Buffer requires that as data is 
transformed, clipped and viewport mapped it be sent 
directly to the Picture Generator rather than being 
deposited in the Refresh Buffer for display on the 
screen. This means that a new frame must be generated 
by the control program. for each refresh cycle. To 
avoid flicker, the control program is therefore 
constrained to update the display at least 30 times 
per second. This limits, to a certain. extent, the 
applications in which THE PICTURE SYSTEM can be used, 
but provides for programs and applications written for 
this minimal configuration to be easily upgraded to 
the more flexible standard PICTURE SYSTEM 
configuration. 
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The Graphics Software Package is used as in the 
standard PICTURE SYSTEM configuration with the 
exception of the NUFRAM subroutine. This subroutine, 
usually called to initiate the display of a new frame, 
is not required in programming a non-Refresh Buffer 
configuration. This is because all data is displayed 
as it is transformed. For this reason, the user 
simply restarts the display loop rather than call 
NUFRAM?, The user variables ICLOCK and IFMCNT are 
available to the user for display synchronization with 
the line frequency. 


1The NUFRAM call may be included but will function as a 
no-operation call. 
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Figure 5.10-1 


THE PICTURE SYSTEM Starter Configuration 
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5.10.2 


Display of Data in Single Buffer Mode 


THE PICTURE SYSTEM may be used in single-buffer mode 
when the user's display reguirements exceed the 
capacity of half of the Refresh Buffer. This 
condition may be diagnosed by the absence of most of 


the expected data from the picture. (The Refresh 


Buffer Address Register wraps around, leaving only the 
last data drawn available for display.) The user 
selects the single-buffer mode of the Refresh Buffer 
by calling the SETBUF subroutine as illustrated in 
Example 5.10-1. 


¢ INITIALIZE THE PICTURE sysTEM 

CALL PSINIE(3,0,50,%) . 

C AND SET THE REFRESH BUFFER TO SINGLE BUFFER MODE 
ie ~ CALL SETBUF (1) 

C BEGIN THE DISPLAY LOOP 

c | | 


Example 5.10-1 


The user may select single- or double-buffer modes at 
any time during the execution of any given program. 
The user should, however, be aware ‘of the subtle 
difference between the use of the Refresh Buffer in 
Single- and double-buffer modes. As Figure 5.10-2 
illustrates, in single buffer mode, the data displayed 
on the Picture Display is the same data which is being 
updated by the user program. This may result in a 
refresh cycle which displays a portion of the user's 
old data (old frame). In cases where the data may not 
change drastically from frame to frame or where there 
are many refresh cycles between frame updates, this 
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Figure 5.10-2 


A Single Buffered Refresh Buffer 
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be of little consequence. The structure of a program 
which uses single-buffer mode is, nonetheless, the 
same as if the Refresh Buffer were double- buffered. 
In either case the user draws! all of the data that is 
to be displayed and then calls the NUFRAM subroutine 
so that the next data drawn will be stored at the 
beginning of the Refresh Buffer. This is shown in 
Example 5.10-2. If no subsequent data is drawn, the 
picture will appear static on the screen. 
Alternately, the single-buffered Refresh Buffer may be 
used in a manner similar to a storage tube display. 
In this manner, the user fills the Refresh Buffer with 
the data which is to be viewed. This data will 
continue to be refresed until an "erase" of the 
Refresh Buffer is initiated by the user. The 
equivalent of an "erase" is provided by calling the 
NUFRAM Subroutine twice in succession. Therefore, a 
user could write an ERASE subrout‘ine. Example 5.10-3, 
which could then be called to "erase" the Picture 
Display. 


1The term draws here means that the data will be 
transformed, clipped, viewport mapped and stored into the 
Refresh Buffer where it will be displayed (or drawn) upon 
the next refresh cycle. 


5-119 


aan AAN 


aaa 


-AAN OS Oa 
: Oo 


ana ana 


INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT(3,0,, 52) 
SET THE REFRESH BUFFER. TO SINGLE BUFFER MODE 
CALL SETBUF (1) 
SET THE WINDOWING TRANSFORMATION 
CALL WINDOW (-4000,4000, -4000,4000 ,-4000,4000, 8000) 
SAVE WINDOWING TRANSFORMATION AND BEGIN THE DISPLAY LOOP 
CALL PUSH 


MODIFY OR OBTAIN NEW TRANSFORMATION PARAMETERS 


CONCATENATE THE TRANSFORMATIONS 


CALL TRAN(ITX,ITY,ETZ) 
_ CALL ROT (IANGLZ,3) 
CALL ROT (IANGLY,2) ~ 

CALL ROT (IANGLX,1) 

CALL SCALE (ISX, IS¥,IS2Z) 


NOW TRANSFORM THE ‘DATA BY THE COMPOUND | TRANSFORMATION 
CALL DER GST AEDAER Ms 11 ,IF2) 
AND DISPLAY THE DATA AND LOOP AGAIN 


CALL NUFRAMS 
CALL POP 
GO TO 100 


Example 5.10-2 
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SUBROUTINE ERASE 


THIS WILL ESSENTIALLY ERASE THE CONTENTS OF THE 
REFRESH BUFFER ALLOWING THE PICTURE SYSTEM TO BE 
USED AS IF IT WERE A STORAGE TUBE DISPLAY. 


NOTES THE “ERASURE" WILL TAKE ONE REFRESH CYCLE 
AS DEFINED IN THE CALL TO PSINIT. 


ANAANAAAAN 


CALL NUFRAM 
CALL NUFRAM 
RETURN 

END 


Example 5.10-3 
The user is free to use the single buffered Refresh 
Buffer in either of the previous ways described, or in 
some combination thereof. Example 5.10-4 illustrates 


this with the use of the ERASE subroutine of Example 
5.10-3 only between major frame changes. 
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SUBROUTINE .MFRAM2 


c Boned 7 
C THIS SUBROUTINE DISPLAYS THE 2ND MAJOR FRAME OF 
C THIS PROGRAM. IT IS ASSUMED THAT AN ERASE WAS @ 
C PERFORMED IMMEDIATELY BEFORE THIS MODULE WAS | 
C CALLED (WITH THE REFRESH BUFFER SET TO SINGLE 
C BUFFER MODE). 
c 
C BEGIN DISPLAY Loop 
Cc 
c - 
C EXIT FROM THIS MODULE YET ? GO TO 1000 IF so 
c 
IF (IDONE.NE.0) GO TO 1000 
c a, 


CALL NUFRAM 
GO TO 100 


Ce ee 

C POP THE ORIGINAL MATRIX, ERASE THE DISPLAY AND EXIT 
Chita Re ae 
1 


000 .. CALL Pd on 
CALL ERASE 


Example 5.10-4 
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5. 10-3 


Display of Data in Double-Buffer Mode 


The Refresh Buffer is typically used in what is termed 
double-buffer mode where the Refresh Buffer is divided 
into two separate buffers. For this reason, the 
default usage of the Refresh Buffer is double- 
buffered, initialized to that state by PSINIT when 
called by user program. In this mode, the user fills 
a buffer with data to be displayed, calls the NUFRAM 


‘subroutine to initiate its display and then may 


proceed to fill the other buffer with new frame data. . 
This is illustrated by Figure 5.10-3. This method of 
frame display frees the user to create a new frame at 
his leisure without worry of degradation of his 
picture. Example 5.10-5 shows the structure of the 
display loop of a typical applications program which 
utilizes the double-buffer mode. If the user's 
application requires that the Refresh Buffer be used 
in single-buffer mode for a given set of frames and 
then returned to double-buffer mode, it would be done 
as shown in Example 5.10-6. 
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INITIALIZE THE PICTURE SYSTEM 


CALL PSINIT (340¢s¢¢) 
SET THE WINDOWING TRANSFORMATION 
CALL WINDOW (-4000,4000,-4000,4000 ,-4000,4000, 8000) 
SAVE THE WINDOWING TRANSFORMATION 
00 CALL PUSH 


MODIFY OR OBTAIN NEW TRANSFORMATION PARAMETERS 


AANAARAANNQ AAN AN 


Cc 
Cc CONCATENATE (THE TRANSFORMATIONS AND DISPLAY THE DATA 
Cc TWICE 
CALL TRAN {ITX, ITY, ITZ) 
CALL: ROT (IANGLZ, 3) 
CALL ROT (IANGLY, 2) 
CALL ROT (IANGLK, 1) 
CALL PUSH .- 
CALL SCALE (ISX1, Is¥1 »ISZ1). 
‘CALL DRAW3D(IDATA, N, IF1,IF2) ae ia. 
CALL POP 
CALL SCALE (ISX2, ISY2,1SX2) 
CALL DRAW3D(IDATA,N, IF2, IF2) 
Cc 
Cc RESTORE THE ORIGINAL WINDOW THAT WAS SAVED 
Cc 
CALL POP 
Cc 
Cc AND DISPLAY THE DATA AND LOOP AGAIN 
Cc 


CALL NUFRAM 
GO TO 100 


Example 5.10-5 
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ENTER THE DISPLAY SEGMENT WHICH MUST USE SINGLE BUFFER 
CALL SETBUF (1) 


BEGIN DISPLAY OF THE SINGLE BUFFERED DATA 


Maan ana 


00 . 


EXIT SINGLE BUFFER MODE? (LOOP IF NOT) 
IF (IDONE.EQ.0) GO TO 500 


| RESET BUFFER MODE TO DOUBLE BUFFERED 


ANA ANN 


CALL SETBUF (2) 


‘Example 5.10-6 — i 
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BUFFER | NEW FRAME 


DATA 


CURRENT POSITION 
“OF NEW 
FRAME UPDATE 


POINTER. 
BUFFER 2 | 
OLD FRAME THE REFRESH CYCLE 
DATA DISPLAYS ALL OF _,.__ 
THIS DATA @ 
LAST DATA . 


OF THEOLD ——> 
FRAME 


Figure 5.10-3 


A Double-Buffered Refresh Buffer. 
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‘5. 11.1 


INTERACTION USING THE TABLET 


Data may be input to THE PICTURE SYSTEM by any of the 
various standard DEC peripherals available for the 
PDP-11, or by any of the standard Evans §& Sutherland 
graphical input devices. The Tablet, however, serves 
as the standard, general purpose graphic input device 
for THE PICTURE SYSTEM, performing those interactive 
functions usually reserved for such graphic input 
devices as light pens, joy sticks and function 
switches. This section discusses in detail how the 
Tablet may be used to perform pointing, positioning, 
and other miscellaneous functions required for 
flexible interactive data input. 


Tablet and Cursor Use [TABLET,CURSOR,ISPDWUN ] 


Data is input from the Tablet within a user 


application program by calling the TABLET subroutine. 


The following is the TABLET calling sequence 
specification of Section 4.13 


CALL TABLET (ISTAT[,IX,1Y,IPEN}) 


This subroutine is called with ISTAT=0 to read the 
current pen x,y coordinates and status. The pen x,y 
coordinates which are returned in the IX and IY 
parameters are scaled integer values whose 
approximate range is #32700. The Tablet is considered 
to be a two-dimensional input device whose —coordinate 
system origin is at the center of the tablet, as shown 
in Figure 5.11-1. . 


This .coordinate system was chosen for the tablet so 
that the values returned to the user could be used 
directly for pointing, positioning and tracking. The 
pen status is returned to the user in the parameter 
IPEN, so that the pen information may be determined by 
the user. The status that is returned is the 
information as read directly from the tablet. The 
status information returned is shown in Figure 5.11-2. 


iThe x,y coordinate values are scaled from the actual tablet 
coordinate range {0-1777,) to the approximate data space 
range £+32700 (t77700,). 
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As Figure 5.11-2 shows, the user may determine when 
the pen is down (i.e. pressed against the surface of. 
the tablet) by testing bit 1 of the pen status word. 
Since bit testing capabilities are not provided 
directly by FORTRAN, the integer function subroutine 
ISPDWN is available to the FORTRAN programmer to 
determine whether or not the pen is down. This 
function subroutine returns the value 0 if the pen is 
not down or 1if the pen is down. This is illustrated 
by Example 5.11-1. 


el 


READ THE TABLET VALUES AND PEN STATUS 
CALL TABLET (0,1X,IY,I PEN) 

ced THE PEW Is. Dow, GO 70 100 
| TF (ISPDWN (ZPEN) NE. 0) GO TO 100 


THE PEN. Is NOT. DOWN, 50 CONTINUE 


ANNA AAN ana 


Example 5.11-1 


The user may choose to utilize the tablet in what is 
termed automatic mode by setting the ISTAT parameter 
to a non-zero value. In this mode, the user "turns 
on* the TABLET subroutine and the pen x,y coordinate 
and status are then updated automatically upon each 
refresh interrupt. In this way, the user constantly 
has avilable the most recent tablet values without 
explicitly calling the TABLET subroutine. Example 
5.11-2 shows how the tablet may be used in automatic 
mode. 
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: Figure 5-11-1 


The Two-dimensional Coordinate System of the Tablet 


I5 1413 12 1110 987665 43 2 5 0 


' PEN UP/DOWN yes 


O=PENUP 
| =PEN DOWN | 

PEN PROXIMITY: 
O= NOT IN PROXIMITY 
t= IN PROXIMITY 


Figure 5.11-2 


The Pen Status as Returned by the TABLET Subroutine 
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INTEGER IX,IY,IPEN 


INITIALIZE THE PICTURE SYSTEMS 
CALL PSINIT (3,0¢0¢¢) 


AND TURN ON THE TABLET FOR AUTOMATIC MODE 


AaAnN AaA-AN 


CALL TABLET (1,IX,IY,IPEN) 


BEGIN THE DISPLAY LOOP BY SEEING IF THE PEN IS DOWN 
IF (ISPD WN (IPEN) .EQ.0)GO TO 200 


THE PEN WAS DOWN... 


NAAR ANN 
oO 
Oo 


Example 5.11-2 


When used in either automatic or non-automatic mode, 
the TABLET subroutine requires the user to acknowledge 
that the pen information has been read by clearing the 
IPEN parameter. If this parameter is not zero when 
the tablet values are to be updated, then the x, y and 
pen status will not be updated unless the pen is down. 
This requirement ensures that the user will not "miss" 
-anmn occasion when the pen has been set down and always 
has the most recent position (x,y) where the pen was 
set down. Example 5.11-3 illustrates the clearing of 
the IPEN parameter after the pen position has been 
determined. 
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IF THE PEN IS NOT DOWN, BRANCH TO 200 - 


Cc 

Cc 

Cc 

100 IF (ISPDWN(IPEN) .EQ.0) GO TO 200 

Cc 

Cc THE PEN IS DOWN...DETERMINE THE MENU SELECTION 
Cc 


c 
C MENU SELECTION DETERMINED...INDICATE PEN POSITION 
Cc. READ 
c 

7 IPEN=0 
C CONTINUE DISPLAY LOOP 
2 


00° CONTINUE 


Example 5.11-3 


It is often convenient to provide a visual feed back 
of the current pen position in relation to the tablet. 
For this purpose, a “cursor® may be drawn on the 
Picture Display at a position which corresponds to the 
X,Y position of the pen on the tablet by calling the 
CURSOR subroatine. The following is the CURSOR 
calling sequence specification of Section 4.1: 


CALL CURSOR(IX,IY,ISTAT[, IPEN }) 
This calling sequence allows a cursor symbol to be 
displayed at the position specified by the Ix and IY 


parameters. The cursor which is displayed is a simple 
cross which is centered at the X,Y coordinate 
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specified. The pen status (IPEN) is an optional 
argument which, if specified, provides visual feedback 
of the pen status hy displaying the cursor brighter 
whenever the pen is down, and also provides the 
information so that the cursor will not be displayed 
when the pen is not in the proximity of the tablet. 
If the argument is not specified, the cursor will 
always be displayed at maximum intensity. Example 
5.11-4 shows the use of the CURSOR subroutine with the 
optional argument. 


As with the TABLET subroutine, the user may optionally 
choose to display a cursor in what is termed automatic 
mode, by setting the ISTAT parameter to a non-zero 
value. In this mode, the user "turns on" the CURSOR 
subroutine and a cursor will then be displayed 
automatically upon each refresh interrupt. In this 
way, the user constantly has displayed the current pen 
position without explicitly calling the CURSOR 
subroutine. When used in automatic mode in 
conjunction with the TABLET subroutine, the user will 
always have the current position of.the pen displayed 
regardless of the frame update rate of a particular 
applications progran. Example 5.11-5 shows how the 
automatic mode of the TABLET and EARSOR subroutine may 


sa pepeet tied. 


INTEGER IX,1Y,IPEN 


c . 

C INITIALIZE THE PICTURE SYSTEM 

c ; 
CALL PSINIT(3,0,,¢,,) 

"TURN ON" AUTOMATIC MODE FOR THE TABLET AND CURSOR 

CALL TABLET (1,1X,1I1Y,IPEN) 
CALL CURSOR (IX,IY,1,IPEN) 

Cc 

C NOW BEGIN THE DISPLAY LOOP WITHOUT WORRYLNG 

C ABOUT TABLET UPDATE AND CURSOR DISPLAY. 

Cc 


Example 5.11-5 
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It should be noted that the tablet x,y coordinates 
need not be used to position the cursor. If the 
cursor is to be positioned by other means (i.e. 
control dials, arithmetic computations, etc.),. the 
variable which will contain the x or y positioning 
information should be specified rather than the pen 
coordinate variables. The CURSOR subroutine, however, 
expects an x,y position value in the range of 
approximately +32700 to be specified. There is, of 
course, no restriction on the use of values to specify 
that the cursor always be displayed at a given x or y 
position, as shown by Example 5.11-6. 


INTEGER IX,IY,IPEN, ZERO 
DATA ZERO/0/ 


INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT (3,0, ee.) 


SET TABLET, CURSOR AUTOMATIC MODE(CURSOR ALWAYS AT 
“y=0) . 
CALL TABLET (1,1X,IY,IPEN) 
CALL CURSOR (IX,ZERO,1) 


Example 5.11-6 
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The cursor is defined in a window running from ~32767 
to #32767 in x and y, which coincides appoxinately 
with the range of tablet values. 


The cursor will always be displayed within a viewport 
which is specified by the variables which defined the 
viewport in effect when the CURSOR subroutine was 
called. In Examples 5.11-5 and 5.11-6, this means 
that the cursor will always be displayed in a viewport 
which is the entire screen (since PSINIT last 
specified a viewport}. Hovever, as Example 5.11-7 
shows, a cursor can be displayed within a dynamically 
changing viewport merely by calling the VWPORT 
subroutine before initiating automatic TABLET and 
CURSOR modes and then modifying the variables which 
defined the viewport. This feature proves useful in 
menu and data pointing functions. 
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anaa | 
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210 


INTEGER IVL,IVR,IVB,IVT, IH, LY 
DATA IVL,IVR, IVB /-2048,2047 07 2048/ 
DATA IVT, IVH, IVY/2047, 255,0/ 


INITIALIZE THE PICTURE SYSTEM 
CALL PSINIT(3,0,,,,) 


SET THE INITIAL VIEWPORT 
CALL VWPORT(IVL,IVR,IVB,IVT,IH,IY) 


SET TABLET, CURSOR AUTOMATIC MODE 
CALL TABLET (1,I1X,IY,IPEN) 


CALL CURSOR (IX, 1IY,1,IPEN) 
IPOINT=0 


BEGIN THE DISPLAY LOOP... 


__IF IPOINT=0 THEN RESET THE MAX VIEWPORT FOR 
CURSOR DISPLAY, OTHERWISE SET ANOTHER “NEOARORS 


IF (IPOINT. £Q-0). GO TO 200 


IVL=-1024 
IVR= 1024 
IVB=-1024 
IvT= 1024 
GO TO 210 


RESET THE VIEWPORT VARIABLES FOR MAX SIZE VIEWPORT 


IVL=-2048 
IVR= 2047 
IVB=-2048 
IvT= 2047 
CONTINUE 


Example 5.11-7 
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5.11.1 


Se 11.2.1 


Pointing 


The user nay input data interactively with the tablet 
by: 


1. selecting a menu item which specifies a 
command to be performed. 

2. identifying a data element with which the 
user wishes to interact. 


Both of these functions may be considered to be 
pointing functions; i.e. the user points to a menu 
item or points to a particular data element. However, 
the implementations of the two pointing functions are 
typically different. The following two sections 
describe the use of the Tablet to perform these two 
pointing functions. 


Pointing at Menu Items 


A menu item is a symbol, usually text, which when 
selected by the user issues a command to the user’s 


program. Figure 5.11-3 shows a menu which includes. 


both text and other symbols as menu items. In this 


program, the user would position the pen on the tablet. 


to the location which would ‘correspond to the menu 
item to be selected, and press the pen down indicating 
to the program-that the particular menu item, whose 
boundaries contain that x,y position, is being 
selected. The program would then initiate the action 
required for the particular menu item selected. The 


‘user may programmably determine which (if any) menu 


iten is being selected by comparing the x,y 
coordinates of the pen with the boundaries definéd for 
each of the menu items. However this comparison need 
be performed only if the pen is down. Example 5.11-8 
illustrates how this may be done. 
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LEFT 


Figure 5.11-3 


A Menu which Includes both Text and other Symbols 
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Cc ‘ 
C IF THE PEN IS DOWN, ENTER THE MENU SELECTION CODE, 
C OTHERWISE, BRANCH TO 300 
c 
IF (ISPDWN(IPEN).EQ.) GO TO 300 
c 
C MENU SELECTION...COMPARE THE MENU AREAS WITH 
C THE TABLET X,Y COORDINATES 
IF(IY.LE.0) GO TO 250 
c 
C UPPER PORTION OF MENU AREA, LEFT OR RIGHT SIDE? 
Cc 
IF (IX.LE.24576) GO TO 230 
¢€ 
C UPPER RIGHT SIDE...UPPER OR LOWER MENU ITEM? 
Cc 
IP (IY.LE.16384) GO TO 210 
Cc 
C UPPER,UPPER RIGHT MENU ITEM...PERFORM SELECTED 
C FUNCTION a 7 
ae 
Cc - a F . .. ties acta. sy x 
C MENU ITEM SELECTION COMPLETED, INDICATE PEN 
C POSITION READ 
Cc pate 
IPEN=0 
300 CONTINUE 


Example 5.11-8 


A feature of the tablet is that the menu may be only a 
paper overlay which is placed on the tablet, or a menu 
may be displayed on the screen which corresponds to 
the menu areas on the tablet, enabling the user to 
point with the cursor to the menu area on the screen 
to select a menu item. An additional feature is that 
a viewport may be defined within which the non-nenu 
data may be mapped and displayed without extending 
into the menu areas, as shown in Figure 5.11-4. 
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5.1102-2 Pointing at Data Elements [ HITWIN,HITEST] 


A data element is typically pointed at by the user to 
indicate that a particular function is to be performed 
upon, or in relation to, the data element pointed at. 
Such functions might be the deletion of the data 
element, the stress computation on the element in 
relation to its neighboring elements, or any other 
function which may be programmed as a particular 
application. This pointing function, often 
erroneously considered to be strictly a light pen 
operation, is performed with THE PICTURE SYSTEM by 
what is known as "hit testing". This function, 
performed by the Picture Processor's clipping process, 
allows a “hit window" to be defined through which all 
data in question may be processed to determine whether 
any of the data was "hit"; i.e. whether any point 
(visible or not), or any part of any line, fell within 
the "hit window". 


This process is superior to the analogous function | of 
the light pen in nevers’ ways: 


1. The hit epee feature, when coupled with the 
TABLET and CURSOR subroutines, allows the | 
user the ability to point at and identify data 
elements, with the added flexibility that the 
size of the "hit window" or region of interest 
described about the pen position may be varied 
.dynamically to allow a wide range of pointing 
resolution upon user demand. 

2. The "hit window", while usually positioned “by 
the x,y coordinates of the pen on the tablet, 
may be specified arithmetically, allowing data 
which is not even displayed to be "hit", 

3. The “hit testing" technigue requires no trace 
back within the display file to determine which 
data element was “hit" since the user programma} 
controls the ievel to which "hit testing" is . 
perforned. 
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DATA MAPPED 
TO VIEWPORT 


BOUNDARIES 
PLACE ROTATE [MOVE . 
DELETE HIGHER LOWER RIGHT UP OUT 
SPIN LONGER SHORTER 
Tey be WIDER NARROWER _|LEFT DOWN 


Figure 5.11-4 


'e ; 
hs 


a 
A 


A Displayed Menu Illustrating Pointing 
at Menu Item with the Cursor and Data which 
had been Clipped, Mapped to the Viewport 
Boundaries. 
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The “hit testing" capability is provided within the 
Graphics Software Package by the HITWIN and HITEST 
subroutines. The following are the HITWIN and HITEST 
calling sequence specifications of Section 4.1: 


CALL HITWIN(IX,IY,LSIZE[,IW }) 
CALL HITEST (IHIT,ISTAT) 


The HITWIN subroutine is called to specify a "hit 
window" through which data may be processed to 
determine whether any of the data was "hit", HITWIN 
also suspends output to the Refresh Buffer, since 
"hit" testing uses the transformation and clipping 
facilities of the Picture Processor in a way which 
would result in misplaced picture elements if they 
were allowed to be displayed. The "hit window" is 
centered at the x,y coordinates specified by the Ix 
and IY parameters and whose half-width and half-height 
is specified by the ISIZE parameter. All three 
parameters will =§be scaled by the homogeneous 
coordinate, IW, if it is specified. Such a "hit 
window" is. considered to have finite boundaries in x 
and y directions (determined by the ISIZE parameter) 
and to extend from 0 to IW in the Z direction as shown 
in Figure 5.11-5. The size of the "hit window" may be 
varied by modifying the value of the ISIZE parameter. 
The actual size of the hit window (in inches) may be 
determined by the following ratio: 


ISIZE actual "hit Window" width 
IW actual "hit testing" viewport width 

With a "hit testing" viewport which is the entire 
screen (10 inches_and IW its typical default. value 


(IW=32767), this ratio would reduce to: 


ISIZE actual "hit window" width 


In this case, to achieve a "hit window" which is 1 
inch in widths 
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HiT WINDOW 


SCREEN 


Ix,IyY 


Figure 5.11-5 


The “Hit Window" as Specified by the HITWIN Subroutine Illustrating 
its Boundary = IW. 
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Left Blank Intentionally. 
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a = -- or ISIZE = 3276 
32767 10 


These subroutines allow the tablet to be used in a 
manner similar to a light pen, i.e. any data element 
which appears behind the “hit window" will be "hit" if 
tested during the "hit testing" process. Hit testing 
is performed at a stage in the Picture Processor's 
operation where pictorial data has been completely 
transformed, put in perspective and mapped onto a 
region running from -32767 to +32767 in both x and jy, 
which is identical to the region in which the cursor 
is defined. Hence, if the picture*s viewport is 
identical to that of the cursor (namely, the viewport 
in effect when the CURSOR subroutine was called - 
usually the full screen), then a picture element which 
appears near the cursor will be hit. If the picture 
occupies a viewport other than the full scope, the. 
_cursor should also be confined to that viewport if hit 
testing is to be performed. 


Hit testing may be performed on lines, dots, or the 
origin of a character string, but not the characters 
themselves, since they are generated by the Character 
Generator after the clipping process. — 
The HITEST subroutine is called (normally with 
ISTAT=0) to determine whether any data has been “hit" 
since the "hit window" has been specified or since the 
last call to the HITEST subroutine. This allows the 
user control over the level to which hit testing is 
performed; i.e. groups of data sets may be tested at 
once, or a single data element can be individually 
tested merely by the placement of the call to the 
HITEST subroutine. This subroutine is also called at 
the completion of the "hit testing" process with 
ISTAT#0 to restore the transformation which was in 
effect at the initiation of "hit testing" and to reset 
the Picture Processor so that all subsequent data 
drawn will be output to the Refresh Buffer. 


The HITWIN and HITEST subroutines should be called in 
the following manner: 


1. CALL the HITWIN subroutine to set the 
desired "hit window". This window 
will be centered at the x,y coordinate 
and of the size specified by the user. 
Typically, the x,y coordinates are 
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those returned by the TABLET sub- 
routine but may correspond to any 
values, dynamic or otherwise. 

2. Draw each data element, or data set, 
for which “hit testing" is to be performed 
(the data is not actually drawn but is 
processed for hit testing purposes 
only). 

3. Determine whether a "hit" has been made 
upon the data element or data set by 
calling the HITEST subroutine and 
testing the IHIT parameter whose 
value will be returned: 

=0 if no hit occurred. 

=1 if a hit has occurred since the 
initial call to HITWIN or the 
last call to HITEST. 

4. Steps 2 and 3 may be repeated as required 
to determine the data element or data 
set which was "hit", The final call to 
HITEST should have the second argument, . 
ISTAT, set to a non-zero value to restore 
the transformation in effect when the 
HITWIN subroutine was called and to allow 
subseguent data drawn to be written into 
the Refresh Buffer. 


The previous steps (1-4) specify the manner in which 
hit testing should be performed using the HITWIN and 
HITEST subroutines. The user should note that the 
transformations performed upon the data when it is 
displayed must also be performed upon the data when 
"hit testing". | ‘These transformations include 
WINDOWing, ROTation, TRANSlation, SCAL(E)ing and 
INSTancing. This simplifies the "hit testing" process 
Since it may be done within the logical flow of the 
program, while (or as if) a new frame is being 
created. Example 5.11-9 illustrates how "hit testing" 
may be used to determine if an object, in this case a 
“HOUSE" has been hit. 
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00 


INITIALIZE THE PICTURE SYSTEM AND TURN ON 
AUTOMATIC TABLET AND CURSOR 


CALL PSINIT(3,0¢0 ee) 
CALL TABLET (1,1X,1Y,IPEN) 
CALL CURSOR (IX,IY,1,IPEN) 


SET THE PERSPECTIVE WINDOW 


CALL WINDOW (-5000,5000,0, 10000,0, 10000,-20000) 


BEGIN THE DISPLAY LOOP BY PERFORMING THE 
TRANSFORMATIONS 


CALL PUSH 

CALL TRAN (ITX, ITY, ITZ) 
CALL ROT (IANGLZ,3) 
CALL ROT (ZANGLY,2) 
CALL ROT (IANGLX,1) 


IS THE PEN DOWN? IF-SO BEGIN HIT TESTING 


I= ISPDWN (IPEN) 
IF (I-WE.0) CALL HITWIN (IX, IY, 1000) 


CALL THE SUBROUTINE WHICH DRAWS THE OBJECT 


“CALL HOUSE 


IF NOT HIT TESTING PROCEED WITH THE DISPLAY 


LOOP, OTHERWISE... 
IF(I.£Q.0) GO To 200 
HIT TESTING... WAS BEGIN PERFORMED 


CALL HITEST {J,1) 
IF (J.EQ.0) GO TO 200 


IT WAS HIT, UPDATE THE VALUES ACCORDINGLY 


IPEN=0 
CONTINUE THE DISPLAY LOOP 


CONTINUE 


Example 5.11-9° 


5-146 


5.11.3 


Positioning 


The Tablet is a natural positioning device, since the 
current x,y coordinates of the pen may be read at any 
time, and when the TABLET subroutine is used in 
automatic mode the most recently read pen coordinates 
are available at all times without specifically 
calling the TABLET subroutine. The x,y coordinates of 
the pen which are returned by the TABLET subroutine 
are in the range +32700, a direct relation with the 
range of the data space values. This allows the user 
to directly use the pen coordinates to position data 
elements within the data space performing such 
functions as; line endpoint positioning, dragging, 
inking and rubber-band lines, with a mininal amount of 
software effort. 
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APPENDIX A 


SPECIFICATIONS OF THE PICTURE SYSTEM 


This appendix includes the Functional Specifications for 

THE PICTURE SYSTEM as well as the detailed Hardware Specifi- 
cations for the Picture Processor. The Functional Specifica- 
tions provide the performance statistics describing the 
capabilities of THE PICTURE SYSTEM as a general purpose 
graphics system. The Picture Processor Hardware Specifica- 
tions provide the interfacing, command and data details 
reguired to utilize the hardware at a systems level. 


het THE PICTURE SYSTEM PUNCTIOWAL SPECEPICRTIONS. 


The following describes the functional specifications of 
THE PICTURE SYSTEM. These specifications detail the capa- 
bilities of each of the components of the syster: the 
Picture Controller, Picture Processor, Refresh Buffer, 
Character Generator, Picture Generator, Picture Display 
and Tablet. 


A.1.1 Picture Controller 
General Functions - Contains the data base, 
- Executes the display programs. 
- Performs input/output operations. 


Computer? - Any DEC PDP-11 Family Computer. 
Word Size - 16 Bit. 
Dimension Modes - THE PICTURE SYSTEM displays two- 


and three-dimensional objects. 

- Iwo-dimensional data requires two 
words of Picture Controller memory 
to store the x and y coordinate 
values of a point. 

- Three-dimensional data requires 
three words of Picture Controller 
memory to store the x, y, and z 
coordinate values of a point. 

- Homogeneous coordinate data repre- 
sentation can be used with THE , 
PICTURE SYSTEM in order to provide 
a much larger effective dynamic 
range by scaling the normal two- 
and three-dimensional data. 


Guovdiwars Speci fica- - Absolute coordinates (A) used to 
tion Modes ne define points which are a given 
m4 displacement from the origin of 
the data space. ea 

- Relative coordinates (R) used to 
define points which are a given 
displacement from the previous: set 
of coordinates. 

- Picture elements may be specified 
in any of the following sequences 
of coordinate point definitions: 

@ A,A,A,zA,.e% 
@e A,R,R,R,.0e 
e R,R,R,R,e se 


position to a specified location 
with the beam intensity off. 


Drawing Modes - The Move mode (M) moves the beam 


1THE PICTURE SYSTEM may be interfaced to any PDP-11 Family Computer. 
PICTURE SYSTEMS have been interfaced to PDP-11/05, PDP-11/35 and 
PDP-11/45 computers with various standard DEC peripherals includ- 
ing disks, DECtapes, magtapes, printers, etc. 


Instancing 


Parameter Load/Store 


The Draw To mode (DT) draws a 

straight line from the current 

beam position to a new specified ae 
location and leaves the bean ; é 


position at a new location. 
The Dot mode (D) moves the bean 
position to a specified location 
with the beam intensity off and 
then intensifies the beam at that 
specified location. The beam 
position remains at the dot location. 
The Character mode (C) draws the 
specified character beginning at 
the current beam position and then 
moves the beam position with in- 
tensity off, to the position where 
the next character in a string begins. 
Picture elements may be drawn using 
any of the above modes one by one or 
they may be drawn using any of the 
following sequences of the above 
modes: _ 

© M,DT,M,DT,.- (unconnected 

lines) 
e M,DT,DT,DT,... (lines connected 
end-to-end) 
 . © DI,M,DI,M,.-. (another mode 
cae ts sequence for 
unconnected : @ 


e DI,DT,DT,DT,... (another mode 
sequence for 
lines connected 
end-to-end) 


e D,D,D,D,..-~ (a series of 
dots) 

@. C50, ClCy aus {a string of char- 
acters) 


A method of defining in the data 
base a two- or three-dimensional 
structure once and replicating it 
several times in a picture in dif- 
ferent positions, sizes and orien- 
tations. 

Instancing may be performed to any 
level. 


The Picture Controller can load and 
store all control registers, status 
registers and matrix registers that 
reside in the other components of 
THE PICTURE SYSTEM. 


A.1.2 Picture Processor 


General . 


Transformations 


Compound Transforma- 
tions 


Clipping 


Perspective 


The Picture Processor operations 
are implemented in digital hardware. 


Translates objects in any direction 
in three space. 

Rotates objects about any axis in 
three space. 

Scales objects with respect to any 
of the dimensions in three 

space. 

Perspective transformations can be 
performed on data passed to the 
Picture Processor. 

The Transformation Matrix is expressed 
in homogeneous coordinates which 
allows much larger translational 
values than would otherwise be 
possible. 

Creates mirror images of objects 
about a plane. 


together while maintaining full-word 
accuracy. 

The Transformation Matrix may be 
loaded from the data base or stored 
into the data base residing in the 
Picture Controller memory. a ee 
There is a push-down stack for stor- 
ing four full transformation matrices 
with provision for continuing the. 
stack in the Picture Controller memory. 


Multiplies transformation matrices | 


Extracts the portions of the objects, 
defined in the data base, that are 
within a progran-specified field of 
view. 

In two dimensions, the field of view 
is a program-specified rectangular 
region of the data space. 

In three dimensions, the field of 
view is a pyramid or frustrum (trun- 
cated pyramid) in the data space 
whose apex is at the eye. 

Clipping is performed with respect 
to the program-controlled six sur- 
faces of the frustrun. 


Displays realistic line representa- 
tions of three-dimensional objects 
as they appear to the eye with 
reference to relative distance or 
depth. 


¥Viewport - The viewport specification is under 
program control and. defines a six 
surface region of the Picture Display 
where the picture is to appear. Data 
which has been transformed, clipped, 
and put in perspective is linearly 
mapped into the viewport which allows 
complete separation of the coordinate 
systems of the drawing space and the 
Picture Display. 

- The resolution of the data mapped 
into the viewport is 16 bits, which 
allows this data to be used for 
precision plots. 

- Multiple viewports may be defined 
for a given frame to give simultan- 
eous use of several areas of the 
screen. 

- Specification of viewport front and 

back provides the intensity bounds 
-: Se for depth-cueing. 


Zooming — _ "= The Picture Processor allows for 

ee moving smoothly and quickly into 
(or out of) a complex data structure 
in order to obtain a more detailed. 
{or wide angle) view of a chosen 
region in. the drawing space. 


Hit Test - THE PICTURE SYSTEM can detect whether 

. any part of a given picture element 
is within a program-specified region 
in the data space or on the Picture 
Display. Hit Test is used for imple- 
menting the pointing function with a 
data tablet, eliminating the need for 
a light pen. 


Memory Write Back - Under program control, transformed 
digital data can be written back into 
the Picture Controller's nemory to 
drive a hard copy plotter, for example, 
or as data for further computation. 


A.1.3 Refresh Buffer 
General Function ~ The Refresh Buffer is for storing 
processed digital frame data allow- 
ing complete separation of Picture 
Display refresh requirements from 
the dynamic picture update require- 
ments. 


Data Content ~ Dots and line endpoint data for use 
by the Picture Generator (one com- 
plete dot or line endpoint defination 
per buffer entry containing 12 bits 
for each of the x and y coordinate 
values and 8 bits for the intensity 
value). 
~ Packed character codes for use by 
the Character Generator (up to three 
codes per buffer entry). 
- Status information used to control 
the displaying of the data. 


Buffering . - Program-selectable single or double 
' buffering is standard. 


Cursor ~ dynamic cursor can be maintained 
rasa regardless of the frame update rate. 


Sizet = =. >... ° = In single buffer mode, up to 8188 dots, 
arn Tae ' line endpoints, or character code 

“““@hntries can be stored in the buffer 
in any combination. ~ 

- In double buffer mode, up to 4092 
dots, line endpoints, or character 
code entries can be stored in the ~ 
buffer in any combination. : 


1The Standard Refresh Buffer is 8K, 36 bit words. An additional 
8K of Refresh Memory may be obtained to provide a 16K Refresh 
Buffer. 


A.1.4 Character Generator 
General Function 


Character Set 


Sizes 


Character Orientation 


Accepts character codes and produces 


properly sized digital character 
stroking data for the Picture Genera- 
tor. 


Ninety-six character extended ASCII 
Character set. 


There are 8 character sizes avail- 
able under program control ranging 
from 0.07 inches high in increments 


‘of 0.07 inches to 0.56 inches high 


on the Picture Display. The charac- 
ter width is also under program 
control with 8 different widths 
selectable for each size. 


‘Horizontal 90° counter- ‘clockwise. 


orientation. 


a maxinun of 1725 enacdelere: can be 
displayed at a refresh nate of 30 


_ frames per second. 


A.1.5 Picture Generator and Picture Display 


General Function 


Line Modes 


Intensity Modes 


Intensity and 
Contrast Controls 


Refresh Control 


Display Rates 


Display Type 


Converts digital coordinate and 
intensity information to analog 
voltages to drive an electron bean 
across a phosphor-coated surface. 


Blink mode allows selected picture 
elements to blink on and off. 

Dash mode allows selected lines 

of a picture to be dashed. 


Constant intensity of program-selected 
picture elements may be chosen fron 
256 levels. Lines are drawn at a 
constant rate which assures uniform 
brightness for the chosen intensity 
level. : 

Depth-cueing allows the intensity of 


lines to vary continuously with depth 
(i.e., the z coordinate of the display). 


In order to present a uniform varia-.. 
tion in brightness, the intensity | 
control of the Picture Display treats 
the z coordinate data as the logarithn 
of the intensity to be shown on the 
display. a Ae et 

The contrast control of the Picture . 
Display is completely independent of-— 
the intensity control. 


The refresh cycle is controlled by. 
Synchronization with the power line. 


Move time (for an n" move) 

s .48 x n + 2.0 usec for n 2 2% 

< 3.0 usec for n < 1/2" 
Draw Time (for an n" line) 


< 1.85 x n + 2.0 usec for n 2 1/2" 

< 3.0 usec for n <_ 1/2" 
Dot Time (for dots spaced n" apart) — 

< .6 x n + 4.85 usec for n 2 1/2!" 

< 5.15 usec for < 1/2" 
Appoximate display capacities at 
30 frames per second refresh rates 

#11500 connected 1/2" lines 

¢ 1625 connected 10" lines 
6650 dots 1/4" apart 
1725 characters .14" high (average) 
1500 characters .56" high (average) 


Calligraphic. 


Deflection Type 

Spot Size 

Addressable Locations 
‘Endpoint Matching 


CRT Size 


Phosphor 


A-10 


| Electromagnetic 


0.020 inch. 
4096 x 4096. 
0.020 inch. 


21" rectangular, 10" 
viewing area. 


P4. 


x 10" quality 


A.1.6 Tablet 
General 


Output 


Resolution 


Sampling Rate 


Size 


Cursor 


General purpose interactive input 
device. 


11 bits of x, 1l bits of y, and pen 
up/down status. 


Digital: 11 bits for both x and y. 
Graphic: 100 lines per inch. 


Variable up to 200 samples per 
second. 


11" x 11" useful area. 


The cursor location on the Picture 
Display may be made to correspond to 


' the stylus pen position on the 


tablet. 


A.1.7 PDP-11 UNIBUS Addresses Reserved for the Picture Systen 


The Standard PICTURE SYSTEM reserves the PDP-11 ONIBUS 
addresses summarized by Table A-1, for interfacing to 
the Picture Processor and the various PICTURE SYSTEM 
peripherals available. 


Table A-1 

Reserved Interrupt 
Device Unibus_Addresses, ~_Vector, 
Picture Processor 167770 - 767776 300,304 
Lorgnette : | 767760 ~ 767766 310 
Keyboard ge - 767750 - 767756 | 324 
Switches & Lights #1 767740 - 767746 none 
Switches & Lights #2 767730 - 767736 none 

__ Switches & Lights #3 167720 = 767726 none’ 

Tablet 777730 ~ 777736 330 
Progranmable 767700 - 767706 hone 
Maintenance Panel 
DR11-B - 772410 - 772416 124 


(Picture Processor) 


Ae2 THE PICTURE PROCESSOR HARDWARE SPECIFICATIONS 


The following describes the PDP-11/Picture Processor inter- 
face registers used to communicate the commands and data to 

and from the Picture Processor and the internal register struc- 
ture and functions performed by the Picture Processor. 


A.2.1 PDP-11 Picture Processor Interface Registers 


This section describes the PDP-11 UNIBUS addressable req- 
isters that comprise the command and data interface paths 
between the PDP-11 and the Picture Processor. They are 
functionally divided into three classifications: 


1. Refresh Timing Register 
2. Command Registers © 
3. Data Transfer Registers 


Table A-2 lists these registers and the interrupt vectors 
which are associated with them. The sections that follow 
give detailed descriptions of the functions of the regis- 
ters and the bits within then. 


TABLE A-2 


UNI BUS INTERRUPT 
NAHE | SYMBOL ADDRESS, VECTOR, 
Real Time Clock RTC 767770 300 
Status Register SR 767772 none 
Repeat Status Register RSR 767774 none 
Word Count Register DRHC 772410 none 
Bus Address Register DRBA 772412 none 
DMA Status Register DRST | 772414 124 


A.2.%4.1 Refresh Timing Register (RTC) : 767770, 


REQ 
IEA 

RUN 
CNT 


15 


— 


4 13 12 


io 9 


8 7 6 


a tere 


‘The RTC provides a mechanism for interrupting the PDP-11 
at intervals which are programmable multiples of 1/120 

(The PDP-1T1 Line Frequency Clock interrupts at 
1/60th second). 


second. 


BET 
15-9 
8 


NAME 


“ Unassigne 


- 


Master Cl 
(MC) . 


Unassigne 


Request 
interrupt 
(REQ) 


ear 


d 


When set causes a pulse 
that resets the Picture 
Processor and Picture 
Generator to their 
initial state. This 
provides a mechanisn - 
for initializing the: 
Picture Processor 
without executing a 
RESET command. This 
bit always reads as 
ZeLlO. 


Set every n/120 seconds 
where n is the two's 
complement of the Count 
field (see bits 3-0), 

if bit 4 is set. This 
bit must be cleared by 
the interrupt routine 

to acknowledge interrupt 
service. 


Interrupt 
Enable 
(IEA) > 


Run (RUN) 


Count 3,2,1,0 


Set to allow REQ (bit 6) 


to cause an interrupt. 


Set to allow REQ t 
be set. 


Four bit field loaded 
with two's complement 
of the number (n) of 
1/120 second intervals 
that are desired to 
elapse before BEQ is 
set. Bit 3 is the 
MSB. Clearing all 
bits results in n=16. 


A.2.1.2 Command Registers 


a. Status Register (SR): 


2 ou 


5 4 13 


767772, 


10 


RBSTOPPED i 
RBDONE 
RBSS 
SINGLE 
ND 
‘NC 
oc — 
SPTR - 
"CURSOR 
ENO 
10UT 
on ERU — 
“PPDONE - 


9 8 7 6 5 4 3 2 ! ce] 
ae) 


The Status Register is used to provide global operating 


node information, 


such as single or double buffer, 


to the 


Picture Processor, and also to initiate the display: re- 
fresh process in the Refresh Buffer. 


Bit NAME 
15 RBSTOPPED 
14 RBDONE 


FUNCTION 

Set by the Refresh Buffer 
Control when the refresh 
process stops. Clearing 
this bit causes the re- 
fresh process to start. 
Set by INIT. 


If this bit is set when 
RBSTOPPED is set it indi- 
cates that the refresh 
process has stopped be- 
cause the end of the 
current refresh data has 


13 RB Single 
Step 
(RBSS) 
42 SINGLE Buffer 
11 Unassigned 
12,9,8 New Data (ND), 


New Cursor (NC), 
Display Cursor 
(DC) 


been reached. If it is 
not set it means the 
refresh process has stop- 
ped because a "Status Halt" 
(see Section A.2.1.4) was 
encountered by the Refresh 
Buffer control, or that 

bit 13, RBSS, is set. 

Set by INIT. (Read only 
bit.) 


When this bit is set the 
Refresh Buffer control will 
stop the refresh process 
after each read access 
(RBSTOPPED will be set). 
This is a diagnostic mode 
that enables the data 
accessed by the refresh 
process to be read back 
to the PDP-11 using a 
STORE command. Cleared 
by INIT. 


If this bit is set, the 
Refresh Buffer is configured 
as a Single buffer with a 
four word cursor area and | 
an 8188 word data area. If 
it is clear, the Refresh 
Buffer functions as a_ 
double buffer with two four- 
word cursor areas and two 
4092 word data areas. 
Cleared by INIT. See 

Figure A-1. 


These bits are used to 
indicate special actions 

to be taken by the Refresh 
Buffer control when it 
begins a refresh operation. 
These bits are only sampled 
by the Picture Processor at 
the beginning of the re- 
fresh cycle (i.e. whenever 
RBSTOPPED is cleared). 
Their functions are as 
follows: 


0z-¥ 


‘8191 


REFRESH MEMORY 
AVAILABLE 


] 


> 0-O 


DATA... 


CURSOR ? 
AREA LAR 
, AREAY I 


ae 
DATA 
"| AREA ; 
8191 8191 


DATA 
AREA #2 
STRUCTURED AS 
SINGLE BUFFER 


| STRUCTURED AS 


Figure A-1 


Refresh Memory Structure 


~DOUBLE BUFFER 


NOTE: THE REFRESH BUFFER MAY 
OPTIONALLY BE EXPANDED 
TO TWICE ITS STANDARD 
SIZE TO PROVIDE FOR A 
REFRESH BUFFER OF 16384 
WORDS. 


In_Double Buffer Modes 
ND - Causes the area of the 
Refresh Buffer currently 
assigned as the "write" 
data area to become the 
"read" data area, and as- 
Signs the current "read" 
data area as the new 
"write" area. This pre-. 
pares for the display of 
the data which was just 
written into the Refresh 
Buffer. 


NC - Causes the area of 
the Refresh Buffer cur- 
rently assigned as the 
“write cursor area to 
become the "read" cursor 
area, and assigns the 
current "read". cursor 
area to be the new "write" 
cursor area. Subsequent , 
refresh cycles that dis- 
play a cursor will re- 
fresh from the new "read" 
cursor area._ The re- 
fresh Buffer "write" 
cursor area addressing 
mechanism is initialized 
to point to the begin- 
Ning of the assigned area. 
¢ 
DC - If this bit is set 
when a refresh cycle is 
started, the current 
"read" cursor area con- :; 
tents will be displayed , 
in addition to the con- 
tents of the current 
"read" data area. 


in Single Buffer: 

ND - Causes the Refresh 
Buffer “write" data 
addressing mechanism to 
reset to the beginning 

of the data area, and 
causes the subsequent 
refresh cycle to start 
reading from the beginning 
of the data area. 


Stack Pointer 
(SPTR) 


T2645 


=" CURSOR 


3 ‘Enabile ‘No 
Overlap 
‘(ENQ) 
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Nc - Causes the Refresh 


Buffer "write" cursor 


to be initialized to point 


area addressing i oe 


to the beginning of the 


cursor area. 


DC - (same as double buffer). 


ND, NC, and DC are cleared 


by INIT. 


These bits are used to 
address the currently avail- 
able matrix area on the 
Matrix Stack (see Section 
A.2.2). This field is auto- 
matically incremented after 
a PUSH operation and decre- 
mented before a POP opera~ . 
tion. - If the stack is 
{SPTR=4) and a PUSH is 


attempted, or empty (SPTR=0) _ 


and a POP is attempted the 
STACK ERROR -bit of the ‘DMA 


Status Register (see Section 


A.2.1.4) will be set and 
the operation will not be 
performed. .Cleared by INIT. 


When this bit is set, any 
data that is normally 
written in the Refresh 
Buffer will-be written in 
the currently assigned 
tyrite" cursor area. If 
more than four draw con- 
mands which result in data 
being written into the 
cursor area are executed, 


--then the previous contents 


of the cursor area will be 
overwritten, 


If this bit is set, the 
ATTENTION bit of the DMA 
Status Register (see 
Section A.2.1.4) will be 
set each time a DRAW2D 
or DRAW3D command is 


executed by the Picture 


Processor and if the RSR 
Coordinate Count (see 


Inhibit 
Out put 
(I0UT) 


Enable RSR 
Update _ 
(ERU) 


Picture 

Processor 
Done 
(PPDONE) 
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Section A.2.2b) is such 

that the command would 
normally be repeated, the 
subsequent command execution 
will be inhibited until bit 
0 of the DMA Status Register 
is cleared. This bit is 
useful in "hit testing" to 
determine which draw con- 
mand resulted in the "hit", 
Cleared by INIT. 


When this bit is set, it 
will prevent any data from 
being written into the 
Refresh Buffer. This bit 
is also useful in "hit 
testing" where data passing 
through a hit window would 
appear misplaced if dis- 
played. Cleared by INIT. 


If this bit is set, the ; 
Coordinate Count field of the 
Repeat Status Register (see 
Section b below) equals neg- 
ative-one (all 1's), the 
Picture Processor will auto- 
matically fetch new con- 
tents for the RSR via the 
DMA data path at the end of 
the current command execu- 
tion. Once the new RSR has 
been fetched, it will then 
be treated as a new command 
and a new command execution 
will automatically take 
place. Cleared by INIT. 


When this bit is set it 
means that the Picture Pro- 
cessor is waiting for input 
and has no processing pend- 
ing (it is not an indica- © 
tion of the state of the 
Refresh Buffer). The con- 
tents of the SR and RSR 
registers should not be 
modified until this bit is 
set. The "hit" bits of 

the DRST (see Section 
A.2-1.-4) Should not be 
examined until this bit is 
set, nor should data being 
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written into the memory of 
the PDP-11 by a STORE 
command. Set by INIT. 
(Read only.) 


b. Repeat Status Register (RSR): 767774. 


The 


the 


Repeat Status Register is used to supply commands 
to the Picture Processor... It is called a "Repeat" 
Status Register because portions of its contents may be 
automatically modified in a predetermined manner after 


specified command has been executed, and in certain 


. cases the command is repeated after the modification, 
without required program intervention. 


“The 
1. 


2. 


15,14,13 


bits of the RSR are divided into 3 fields: 


Command - specifies what command type is to be 
executed. This field is never automatically 
modified. 
specification of the command to be executed. 
This field is automatically updated after each 
execution. : 
Many times the command should be executed before 
program intervention is required. If the field 
contains a negative number, it is automatically 
incremented after each command ,execution. 


NAME. FUNCTION 
Command Bits These bits define the 
(COM) command type to be 


executed. The bit combin- 
atiions and interpreta- 
tion are as follows: 


000-2DDRAW Two words are accessed 
from the PDP-11 via the 
data transfer mnechanisna, 

and are then processed 
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001-3DDRAW 


010-PUSH 


011-MATCON 
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by the Picture Processor, 
as specified by the. — 
Finite State Machine — | 
bits. Note that if the & 
Finite State Machine 

bits specify CHARACTER 

or STATUS, then three 

words are accessed from 

the PDP-11. 


Three words are accessed 
from the PDP-11 via the 
data transfer mechanisna, 
and are then processed 
by the Picture Processor 
as specified by the 
Finite State Machine 
bits. 


The current contents 

of the Transformation 
Matrix (see Section 
A.2.2.1) are placed 

into the currently 
available element of 

the Matrix Stack and the 
SPTR is incremented. If 
the SPTR is 4,-the.. 
execution does not take 
place and the STKRR bit 
of the DMA Status Register 
is set. 


Matrix Concatenation - 
Four words are accessed 
from the PDP-11 via 

the data transfer path. 
These four words are 
treated as a row (0-3) 
of a matrix that is 
being post multiplied 

by the Transformation 
Matrix in the Picture 
Processor. The row is 
specified by the Finite 
State Machine (FSM) 
bits. The resulting 

row is placed in the 
Temporary Matrix (see 
Section A.~2.2) of the 
Picture Processor. If 
the row specified is row 
3 then at the end of the 
post multiplication é 


100-PoP 


101-LOAD 


-110-STORE | 


111-NO OP 


12,11, 10 Finite State 
Machine 1 
(FSM 1) 
9,8 Finite State 
Machine 2 
(FSM2) 


process the matrix 
stored in the Temporary 
Matrix is normalized 
and placed in the 
Transformation Matrix, 
destroying the old 
contents of the Trans- 
formation Matrix. 


The last matrix PUSHed 
is returned to the 
Transformation Matrix 
and the SPTR is decre- 
mented. If the SPTR 

is 0 the execution does 
not take place and the 
STKRR bit of the DMA 
Status Register is set. 


Four words are 

accessed from the 

PDP-11 via the data 
transfer path and placed 
in the Picture Processor 
Register (see Section 
A.2.2) eneee tee by the 
FSM bits. 


The fous words which 
represent the contents 
of the Picture 
Processor Register 
specified by the FSM 
bits are sent to PDP-11 
via the data transfer 
path. 


This command is treated 
by the Picture Processor 
as a NO OP. It requires 
that FSM1=7. 


These five bits comprise 
the fields known as the 
Finite State Machines, 
The way they are inter- 
preted is a function of 
the Command bit. 


PUSH, POP 

No effect on operation. 
LOAD, STORE: the given 
bits are interpreted 
as a single field 
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containing an octal 

address (0-27) speci- 

fying which Picture 
Processor Register is g 


to be manipulated. 
The address is incre- 
mented at the comple- 
tion of the command. 


MATCON: The three 
FSM1 bits must be zeros. 
The FSM2 bits represent 
an address (0-3) that” 
specifies which row of 
the matrix to be 
concatenated with the 
Transformation Matrix 

is currently being sent. 
The address is incre- 
mented at the completion 
of the command. 


2DDRAW, 3DDRAW: The 

FSM1 bits are used to. 
describe the type DRAW 

that is desired. At 

the end of the command 

the bits-are -updated.: 

The type, update defini- . 
tions and the FSM1 = } 
sequences initiated are 
listed below: 


VALUE 
AFTER 
TYPE UPDATE SEQUENCES 

MOVETO (M) 1 (M,D,M,D,---) 
DRAWTO (D) 0 (D,M,D,M,.3) 
MOVETO (M) 3 (M,D,D,D,.0-) 
DRAWTO (D) 3 (D,D,D,D,«.3) 
DOT (DOT) 4 (DOT, DOT,...) 
STATUS (S) 5 (S,S,S,S, 008) 
not used 7 
CHARACTER(C) 7 (C,C,CyCyees) 


The interpretations of the 
various types of FSM1 are as 


follows: 


MOVETO: specifies a point in 
the coordinate system, normal- 
ly used as the beginning point 


of a line. 


DRBAWTO: indicates that a line 
is to be drawn from the last 

specified point to the point 

being specified. 


DOT:. Specifies that a dot is to 
be drawn at the point specified. 


STATUS: causes a word to be 
written into the Refresh Buffer 
that consists of parts of the 
three PDP-11 words that must 
accompany the command (see 

Section A.2.1.4d). These words 
are used to change the status 

of the Picture Generator, the 
Character Generator or Color 
within the definition of a picture. 


CHARACTER: causes a word to be 
written into the Refresh Buffer 
that contains the three ASCII 
codes specified by the three. 
PDP-11 words that must accompany 
the command (one ASCII code,. 

right justified, per word). 

When the refresh process encount- 
ers the word in the Refresh ‘Buffer, 
it accesses the Character 
Generator and draws the speci- 
fied characters before making any 
subsequent accesses from the Re- 
fresh Buffer. 


NOTE: See Section A.2.1.4d which 
follows, for the data formats 
of the DRAW Commands. 


The FSM2 bits are used to specify 
whether the data accompanying 
DRAW commands is to be inter- 
preted as absolute or relative 
coordinate data (added to previous— 
data). Note that STATUS and 
CHARACTER commands always imply 
absolute data. At the completion 
of a command execution the bits 
are updated. The interpretation, 
update definitions and the FSN2 


sequences initiated are listed below: 


FSM2 VALUE 
OCTAL AFTER 


VALUE LNTERPRETATION UPDATE SEQUENCES 


Sie ee 


0 ABSOLUTE (A) 1 
1 RELATIVE (R) 1 (R,R,R, ee) 
2 ABSOLUTE (A) 2 (A,A,A, 202) 
3 not used 3 
7-0 Coordinate This 8-bit field is used to 
Count specify how many times the 
(CNT) . command specified by the 


COM bits is to be repeatedly 
executed (with additional 
data each time). The field 
is treated as a_two's 


complement number, with bit 


4. 04 
Leet a 7 being the sign bit. 
If the value of the number 


is positive (bit7=0) the 
command is executed once and 
the 8-bit number is not 
incremented at the completion 
of the execution. If the 
value of the number is nega- 
a —_ tive then the command is 
SEG is « ; executed repeatedly, with the 
number incremented at the end | 
of each command execution, ~@ 
until it goes positive (all 1's 
' to all O's). . 
; If, at the time the coordinate 
count increments from -1 to. 
0, the Enable RSR Update bit 
(bit 2) of the Status Register 


ie is set,_then a word will auto- 
(NAS - i : 


PDP-11 vi 
a. path and placed in the RSR,. 
ow dyndcall The new contents of the RSR 


will then be interpreted anda 
command execution initiated 
automatically. 


A.2.1.3 Command Execution 


The registers described above merely serve to specify the 
command to be executed. To initiate execution a bit in one 
of the data transfer registers must be manipulated. This 
bit is bit 0 of the DRST register, as described in the 
£ollowing section. 


A.2.1.4 Data Transfer Registers 


A-30 


The preceding section dealt with the UNIBUS registers of 
the Picture Processor that are used to pass command infor- 
mation. This section deals with the mechanism that is used 
to pass data between the PDP-11 and Picture Processor. 

Note that data can be transferred in either direction. 


The data transfer path is a DEC DR11-B, Direct Memory Access 
Interface unit. To pass data to or from the Picture Proces- 
sor, a block of PDP-11 memory which contains the data, or 
which will receive the data, is specified by loading regis- 
ters in the DR11-B. The Picture Processor, then, in its 
normal course of executing commands specified by the RSR 
requests the DR11-B to access the memory locations specified. 


ae Word Count Register (DRWC):. 772410. 


The DRWC is a 16-bit Read/Write register. It is ini- 
tially loaded with the two's complement of the number 
of words to be transferred and increments up towards 
zero after each bus cycle. When overflow occurs (all 
lts to all O's), the READY bit of the DRST is set \ 
and bus cycles stop. .DRWC is a word register, byte \ 
instructions. should not be used when loading this \ 
register. This register is cleared by the UNIBUS \ 
INIT signal. 


b. Bus Address Register (DRBA): 1772412, 


The DRBA is a 15-bit R/W register. Bit 0 is always — 
a zero, and is a read-only bit. Along with bits 

5 and 4 of the DRST (XBA17 and XBA16), the DRBA is 

used to specify the address used when the DR11-B 
accesses the UNIBUS. The register is incremented 

(by 2) after each bus access, advancing the address 

to the next sequential word location on the bus. 

If DRBA overflows (177776 to 0) the ERROR bit 

in the DEST is set. This error condition is” 

cleared by loading DRBA or by INIT. DRBA is a / 
word register; byte instructions should not be 

used when loading this register. Cleared by INIT. 


Cr} 


Ceo 


-FNCT 4 
GO 


DMA Status and Command Register (DRST): 772414, 


(5 14 13 f2 Ht to 9 8 FT 6 5 4 3 2 


ERROR 4 


NEX 


ATTN 
MAINT 
STKERR 


fNCT 3,2 


-fhis register is used to provide status indicators 


of the DR11-B, status indicators of the Picture 
Processor, and to provide a means for initiating execu- 
tion of Pictute Processor commands specified by the SR 


and RSR. 
if NASE FUNCTION 
15 ERROR Set to indicate an error 


conditions either NEX 


(BIT 14), ATTN (BIT 13), 


interlock error (test 


board is neither in slots 


ABO2 nor CDO4), or bus 
address overflow (BAOF: 


incremented from 177776 to 0). 


DRBA 


Sets READY (BIT7) and causes 


interrupt if IE (BIT 6) is set. 
ERROR is cleared by removing 
all four possible error condi- 


tions; interlock error is 
removed by inserting test 


board in CDO4 for diagnostic 


tests or in ABO2 for normal opera- 


tion; bus address overflow is — 
cleared by loading DRBA; NEX: 
is cleared by loading bit 14 
with a zero; ATTN is cleared 

by the method described below. 


Read only. 
14 Nonexistent Set to indicate that an UNIBUS 
Memory master, the DR11-B did not 
(NEX) receive a SSYN! response 20 


usec after asserting MSYN2, 
Cleared by INIT or loading with 
a 0; cannot be loaded with a 1. 
Sets ERROR. 


13 Attention This bit is set by the picture 
(ATTN) Processor whenever PUSH or 
POP operation is executed or 
when a 2DDRAW or 3DDRAW command 
is executed and the ENO bit of 
the SR is set. (See Section 
A.2.1.2, bit 3.) The bit is 
read only, in the.sense that it 
cannot be set or cleared by © 
MOVing to DRST. It is cleared 
whenever GO (DRST bit 0) is 


set. 
12 Maintenance Maintenance bit used by diagnos- 
2 Se = (MAINT) ~~ tic’ programs. Cleared by INIT, 
. Read/Write. 


tSee PDP-1 ~Peripherals Handbook, for further UNIBUS signal details. 
2Ibid. 
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11 Stack Error 
(STKRR) 

10-9 Hit Bits 
(HB) 


8 CYCLE 


If this bit is set when ATIN 

is set, it indicates that a 

Matrix Stack overflow or 

underflow has occurred. This € 


read only bit is cleared by 
the same method used to clear 
ATTN. 


These bits are used to 
determine whether data that has 
just been processed during 
2DDRAW or 3DDRAW command execu- 
tion (except STATUS and CHAR- 
ACTER) has been clipped. Once 
the bits have been set they can 
only be cleared by having FNCT1 
set when GO is set. The values 
of the bits indicate something 
of the geometry of the data. 
The figures below show the geome- 
tries that result in the four 
possible combinations of these 
bits, where “N" is the most 
recent coordinate processed, 
and "P" is the one directly 
preceding it. The rectangle 
represents the clipping 


boundaries. 
N 
o——___-4 
P N 
Ol 10 1 


For the bits to be meaningful 
they must be clear immediately 
before execution of the 

2DDRAW or 3DDRAW command in 
question. 


Cycle is used to prime bus 
cycles; if set when GO is 
issued, an immediate bus cycle 
occurs. Cleared when bus 
cycle begins; cleared by INIT. 


7 READY 

6 Interrupt 
Enable 
(IE) 

574 Extended Bus 
Address 
(XBA) 

3-2 FNCT 3,2 
1. PNCT1 
0 GO 


d. Data Formats 


4 


Read/write. 


Set to indicate that the DR11-B 
is able to accept a new command. 
Set by INIT or ERROR; cleared 

by GO; set on word count over- 
flow. Causes interrupt if 

bit 6 is set. Forces DR11-B to 
release control of the UNIBUS 
and prevents further DMA cycles. 
Read only. 


Set to allow ERROR or READY=1 
to cause an interrupt. Clear- 
ed by INIT. Read/Write. 


Extended bus address bit 17 
and 16 that in conjunction 
with DRBA specify an 18 bit 
address to be used for 
direct memory transfers. 
Cleared by INIT. xXBA17 and 
XBA16 do not increment when 
DRBA overflows; instead 
ERROR is set. Read/Write. 


Unassigned, may be used as 
general Read/Write bits. 


This bit is used to allow the 
Clearing of DRST bits 10 

and 9 (HB). The method for 
clearing these bits is to 

set this bit prior to setting 


bit 0 of the DRST. Ready 


Write. 


This bit is set to initiate the 
execution of a command by the 
Picture Processor. Setting 
this bit clears ATIN, if set, 
and if FNCT1 is set it also 
clears the HB bits. Note that 
the setting of this bit always 
causeS a comand execution by 
the Picture Processor. 


The preceding sections detailed the registers used in 
transferring data. This section details the formats 
of the data that accompany the various commands that 
can be specified by the RSR. For each case, the 

data required for one execution cycle is given. 


additional data is required for each execution as 
specified by the CNT field of the RSR. 


PUSH ,POP=: No. data necessary. 

LOAD, STORE,, 4 PDP-11 words. 

BATCON: 

2DDRAW: For all except STATUS AND 


CHARACTER, 2 PDP-11 words 
representing x and y coordin- 
ate values. For STATUS and 
CHARACTER: 3 PDP-11 words,. 
See the data format for STATUS 
and CHARACTER in 3DDRAW. 


DDR AN =. For all except STATUS and 
CHARACTER: 3 PDP-11 
words representing x, y 
and z coordinate values. 


STATUS: 3 words representing: ee 
1. Picture Generator Status. 4 


2. Character GORCEAtOr Statues 
3a Not used. 


: ' i 
CHARACTER: 3 ‘wotaax: Gachceou- 
taining the right justified 


7-bit ASCII code of the char- 
acter desired. 


Picture Generator Status Word: 


Yj Yj Wy Yj Le Y 
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This word accessed by a 2DDRAW or 3DDRAW command and 

a STATUS FSM1, is used to specify global information to 
the Picture Generator. the information specifies that 
color is to be displayed (for color monitor use only), 
whether to draw DASHed lines, put the Picture 

Generator in BLINK mode, what scopes should be 
selected, or whether to stop the Refresh process 
("Status Halt"). 


BIT NAME FUNCTION 
15-12 Unused 


11 TAKE This bit signals the Refresh 
Buffer control that bits 8-0 
are valid and should be loaded 
in the Picture Generator Status 
Register. If it is not set, 
-bits 8-0 are not interpreted. . 


10 HALT If this bit is set the Refresh 
a a Buffer control will stop the 
refresh process (Status Halt). 


8-6 COLOR These bits specify the color 
status for the scopes selected 

by bits 3-0. The octal value 
of these bits specifies the 
color of all subseguent data 
drawn. A value of 0, 1 or 2 
must be used when a black and 
white display is selected. © 
Values 3-7 are used when a 
beam penetration monitor is 
selected. 


COLOR Color Selected 


0 (Black and White Display) 
1 (Black and White Display) 
2 (Black and White Display) 
3 Red 

4 Red/Orange 

5 Orange 

6 Yellow 

7 Green 


5 CASH Indicates that all succeeding 
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lines and characters are to 
be drawn dashed. 


4 BLINK Indicates that all succeeding | 
dots, lines, and characters 
are to blink on the display. 
3 Scope 3 Indicates that the Picture 
Select Display whose scope driver 
(S3) card is in Picture Generator 


backpanel slot 24 will 
display all data subseguently 


drawn. 
2 Scope 2 ‘Same as bit 3, but for slot 
Select 22. 
(S2) 
1 Scope 1 Same as bit-3, but for slot 
Aria 20. — 
($1). ; 
0 scope 0 Same as bit 3, but for slot 
~- Select... : 18. 
ee 


Character Generator Status Word: 
15 14 #13 127 10 9 


Ye 


TAKE ee, 


ROTATE 


XSCALE 


YSCALE 


This word, accessed by a 2DDRAW or 3DDRAW command and 
a STATUS FSM1 is used to specify rotation and scaling 
information to the Character Generator. 


11 TAKE , This bit signals the Refresh 
Buffer control that bits 6-0 
are valid and are to be loaded 
in the Character Generator 
Status Register. If it is not 
set bits 6-0 are not interpreted. 


10-7 Unused 


6 ROTATE 


hoa XSCALE 


SCALE 


MONE WN a © 


ee YSCALE — 


If this bit is set, all sub- 
sequent characters drawn by 
the Character Generator will 
be rotated 909 in the counter- 
Clockwise direction. 


This octal (0-7) number speci- 
fies the X size of all subsequent 
characters; 0 is the smallest, 

7 the largest. 


APPROXIMATE SIZE 
fof Capital Letters) 


0.07" 
0.74" 
0.21" 
0.28" 
0.35" 
0.42" 
0.49" - 
0.56" 


Sane as XSCALE, except speci- 
fying the ¥ size. 


oe Geree Ar2. illustrates the data formats for the 2DDRAW 


“and 3DDRAW commands. 


ALL FSM VALUES EXCEPT CHARACTER AND STATUS 


a 
2D0D0RAW 
ADDRESS 
as ER 


ADDRESS 7777 [ORaRACTER 
n+2 CEES Ws es 
pee 


CHARACTER FSM VALUE 


re ZZ 7 [CHARACTER 


= 


STATUS FSM VALUE 


ADDRESS 'SicTURE GENERATOR 
STATUS 

n¢2 [CHARACTER GENERATOR 
STATUS 


nt4 NOT USED 


Figure A-2 


Data Formats for 2DDRAW and 
3DDRAW Commands 


~ 
{ 

‘7 

oO 


A.2.-2 Picture Processor Internal Registers 


The proceding sections describe the registers of the 
Picture Processor that may be accessed directly with 

PDP-11 instructions. This section describes the registers 
that are internal to the Picture Processor and used to 
contain parameters for various functions or as working 
storage during command execution. Figure A-3 shows these 
registers and the addresses assigned to them These 
addresses are specified using the FSM fields for LOAD and 
STORE commands. Each register consists of four 16-bit ele- 
ments. LOAD and STORE commands always refer to four-element 
registers. 


A.2.2.1 Transformation Matrix (TRANMAT), Register 0-3, 


These four registers are used to contain the 4x4 Trans- 

formation Matrix. This matrix is post-multiplied by the 
data processed during the execution of 2DDRAW or 3DDRAW 

commands (except STATUS and CHARACTER). 


A.2.2.2 Temporary Matrix (TEMPMAT), Register 4-13, 


These eight registers are used to store the temporary 
results during a MATCON operation. They are working 
registers of the Picture Processor and have addresses 

for diagnostic purposes only. They cannot be loaded with 
a LOAD command. ; 


A.2.2.3 Refresh Butter (REPBUR) »- Register 14, 


This read only register (cannot be LOADed) always con- 
tains the data last read from the Refresh Buffer. It is 
addressable for diagnostic purposes only. 


Ao2-2-4 Viewport Left, Bottom, Hither (VIEWL,VIEWB,VIEWH), 
Register 20, 


This register (in conjunction with register 24) is used 
to specify the boundaries to which data that lies within 
the clipping boundaries will be mapped by the viewport 
Mapping process. 

VIEWL is the left boundary 

VIEWB is the bottcm boundary 

VIEWH is the hither boundary 
The fourth component is not used and is undefined. 


A.2.2.5 Save (SAVE), Register 21, 
This is a working register. At the completion of a 


2DDRAW or 3DDRAW command execution (except STATUS and 
CHARACTER) this register contains the data as it 


ADDRESS g 


Addre 


oe >] } TRANSFORMATION 

ay P| PMATRIX 

Pre | 

aan Pare 

aaa a 

ae ee | | | 

——- — TEMPORARY 

eee! Ts _| (MATRIX 

an os Be 

Pn eee a 

Pe ed fees | : | 

IREFBUFY |REFBUFZ|REFBUFS| REFRESH BUFFER 

=e |__| PNOT USED. 

igWH|  —_—i|-sC VIEWPORT LEFT BOTTOM, HITHER 

SAVE 

| Ncy | NCZ | NCW | NEWCLIP 

NEWVIEW 

VIEWPORT RIGHT, TOP, YON 

| BASE Y | BASE Z| BASE — 

| pcy {| PCZ | PREVIOUS CLIP 

- PREVIOUS VIEW 
Figure A-3 


ssable Picture Processor Registers 
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exists after it has been multiplied by the Trans- 
formation Matrix, but prior to any clipping that may 
have taken place. 


New Clip (NC), Register 22, 


This is a working register. The contents are only of in- 
terest at the completion of a 2DDRAW or 3DDRAW command 
execution, (except STATUS and CHARACTER) and then only if 
the data that accompanied the command resulted in data 
that would normally be passed to the Refresh Buffer and 
then the Picture Generator (i.e. a DOT or MOVETO that 

was within the clipping boundaries, or a DRAWTO that 
resulted in a line with some portion within the clipping 
boundaries). For all other cases the contents of this 
register are not defined. (Note that the status of the 
‘hit bits" of the DRST are an indication of whether the 
data was within the clipping boundaries.) If the contents 
are valid, they represent the coordinate values of the 
data within the clipping boundaries. If clipping has 
occurred, they represent the results of the clipping 
computational process, either the original endpoint or 
the coordinates where the line intersected the CEEpAeG 
boundary. . 


New View (NV), Register 23, 


This is a working register. The contents are only of in- 
terest when the NC register has valid information stored. 

in it. The contents represent the results of the view- 

port mapping process that performs the linear mapping and 
perspective division of the data in the NC, from the clipping 
boundaries to the viewport boundaries (specified by the 
viewport registers, 20 and 24). 


Only three of the four elements contain valid information: 
NVX, NVY, NVZ. The fourth element is used strictly as a 
working register, and its contents are not defined. 


It is the 12 least significant bits of NVX and NVY, and 
the 8 least significant bits of NVZ that are written in 
the Refresh Buffer and subseguently passed to the Picture 
Generator during the refreshing process. 


Viewport Right, Top, Yon (VIEWR,VIEWT,VIEWY), Register 24, 


This register (in conjunction with register 20) is used 
to specify the boundaries to which data, that lies within 
the clipping boundaries, will be mapped by the viewport 
mapping process. 

VIEWR is the right boundary 

VIEWT is the top boundary 

VIEWY is the yon boundary 
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The fourth component is not used and is undefined. 


Base Register (BASE), Register 25, 


All 2DDRAW and 3DDRAW commands (except STATUS and CHARACTER) 
result in the Picture Processor performing computations 

on 4 data elements representing the drawing coordinates. 

The BASE register provides two functions. It supplies the 
fourth element, w, for 3DDRAW commands, and the third and 
fourth, z and w respectively, for 2DDRAW commands. The base 
register is also used as the absolute coordinates to which 
all relative details added to compute absolute coordin- 

ates when FSM2 specifies RELATIVE. The base register shoald 
always be LOADED with the necesssary values prior to executing 
2DDRAW and 3DDRAW commands. 


Previous Clip (PC), Register 26, 
This is a working register. Its contents are valid only 


at the completion of a 2DDRAW or 3DDRAW command whose FSM1 
specified a DRAWTO, and whose execution resulted in a portion 


' 9£f the line being within the clipping boundaries, but the 
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beginning of the line being outside the clipping boundaries 

(i.e. the most recent 2DDRAW or 3DDRAW whose FSM1 was HOVETO 

or DRAWTO was accompanied by data that was not within the 
clipping boundaries). For all other cases the contents of 

this register is not defined. (Note that the "hit bits" © 

of the DRST are an indication of whether the above conditions 

are satisfied.) If the contents are valid, they represent 

a point computed by the clipping process that is interpreted é 
as a MOVETO which specifies the beginning point of the por- 

tion of the line that lies within the clipping boundaries. 


Previous View (PV), Register 27, 


This is a working register. The contents are only of 
interest when the PC register has valid information 
stored in it. The contents represent the results of the. 


‘viewport mapping process that performs a linear mapping and 
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perspective division of the PC from the clipping boundaries 
to the viewpcrt boundaries (specified by the viewport reg- 
isters, 20 and 24). 


Only three of the four elements contain valid information: 
PVX,PVY,PVZ. The fourth element is used strictly as a 
wocking register, and its contents are not defined. 


When the beginning point of a line has been clipped, it is 
the 12 least significant bits of PVX and PVY and the 8 least 
Significant bits of PVZ that are written in the Refresh 
Buffer and subsequently passed to the Picture Generator 
during the refreshing process. 


Matrix Stack 


The Matrix Stack is a non-addressable (by LOAD or STORE con- 
mands) collection of registers that are used to temporarily 
store transformation matrices. It is a four level matrix 
stack and is accessed whenever a PUSH or POP command is 
executed. 


A.2.3 Command Execution Details 


This section details the flow of data within the Picture 
Processor internal register structure for each of the 
commands that can be specified by the RSR. In the case of 
2DDRAW and 3DDRAW the operations that take place are 
treated step by step. 


Notes on nomenclature: 


l. IN represents the incoming data that accompanies 
the command. 

2. A "+" refers to a four component (4 16-bit words) 
set of data. 

3. Subscripts such as x, y, z and w refer to the 
individual 16-bit elements of the incoming data (IN) 
or internal registers. 

4. The subscript i is used to specify an internal 
register address (i.e. REGi). 

5. R&B refers to the Refresh Buffer. 

6. In the description of 2DDRAW and 3DDRAW, "new 

point" refers to the data accompanying the con-.. 

- mand, and “previous point" refers to the data ©“ 
. that accompanied the most recent 2DDRAW or 3DDRAW. | 
The term "line" refers to the vector that begins 
/at the previous point and ends at the new Bornes 


A.2.3.-1 2DDRAW and 3DDRAW, FSM1 = DRAWTO 
| ae Input Data to Internal Registers. 


1. If 2DDRAW and FSM2 = ABSOLUTE 
INx —m& PCx, BASEx 
INy —e PCy, BASEy 
BAS Ez —®& PCz, BASEZ 
BASEw —@ PCw, BASEW 


2. If 2DDRAW and FSM2 = RELATIVE 
INx + BASEX —@PCx, BASEx 
INy + BASEy —mPCy, BASEy 


BASEZ —mPCzZ, BASEZ 
BAS Ew —@ PCw, BASEw 

3. If 3DDRAW and FSH2 = ABSOLUTE 
INx —@& PCx, BASEx 
INy —& PCy, BASEy 
INZ —m@ PCz, BASEZ 


BASEw —& PCw, BASEw 


4. If 3DDRAW and FSM2 = RELATIVE 
INx + BASEX —@PCx, BASEx 
INy + BASEyY —@PCy, BASEy 
INz + BASEZ —@PCz, BASEz 
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BASEW —@> PCw, BASEw 


Transform Data. 
—— —— —e 


(PC) x (TRANMAT)-@ SAVE, NC 
Clip 
The clipping process determines whether the data lies within 


the clipping boundaries. [In order for a point to be within 
these boundaries, it must satisfy the following requirements: 


-SAVEw < SAVEx < SAVEw 
-SAVEw © SAVEy < SAVEw 
0 < SAVEz < SAVEz 


1. If a portion of the line is inside the clipping 
boundaries: 


—— 
new point clipped-@ NC 


2. If a portion of the line is inside the clipping 
boundaries, and the previous point is outside the 
eliprnng boundaries: 


—aT 
previous ‘Doane: clip ped-» PC. 


 Perspective/Viewport Transf ormation 


1. Ifa portion of the line is inside the clipping . 
boundaries, and -the prextous point is outside the 
clipping boundaries: 


PCx (perspective and viewport transformed) —@PVx, RBx 
PCy (perspective and viewport transformed)—mPVy, RBy 
PCz (perspective and viewport transformed) —gm@PVz, RBz 


2. If a portion of the line is inside the clipping 
boundaries: 


NCx (perspective and viewport transformed) —gmNVx, RBx 
NCy (perspective and viewport transformed)—mNVy, RBy 
NCz (perspective and viewport transform2d) —mNVz, RBz 


A.2.3.2 20DRAW and 3DDRAW, FSM1 = MOVETO or DOT. 


ae 


Input Data to Internal Registers. 


1. If 2DDRAW and FSM2 = ABSOLUTE 
INX | —e PCx, BASEXx 
INy —& PCy, BASEYy 
BASEz —& PCz, BASEz 
BAS Ew —& PCw, BASEw 
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A.2.3.4 


A.2.3-5 


A.2.3.6 
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Lf 2DDRAW and FSM2 
INx + BASEX —gPCx, 
INy + BASEy —@ PCy, 
BASEz —& PCz, 
BASEw —& PCw, 


If 3DDRAW and FSM2 
INx —m PCx, 
InNy —& PCy, 
INZ —& PCcz, 
BASEw 


If 3DDRAW and FSM2 
INx + BASEX —@ PCx, 
INy + BASEy —@ PCy, 
INz + BASEZ —@PCZ, 


RELATIVE 
BAS Ex 

BAS Ey 
BASEZ 

BAS Ew 


= ABSOLUTE 


BASEx 
BASEy 
BASEz 
—@ PCw, BASEw 


RELATIVE 
BAS Ex 
BASEy 
BAS Ez 
BASEw 


BASEw —e PCw, 
b. ‘Transform Data. 
eis , 


(PC) x (TRANMAT)-~ge SAVE, 


NC 


c. Perspective/Viewport Transformation. 


If the transformed data (SAVE) is within 
the clipping boundaries: . 
dager is 


2DDRAW and 3DDRAW, FSM1 =. STATUS or CHARACTER. 


INX—g» PCx, RBx . 
INy —@™ PCy, RBy 
INZ—m PCz, RBz 


PUSH 
TRANSAT-@Top of Matrix Stack 
(TRANMAT is not destroyed). 
POP 
Top of Stack—gmTRANMAT. 


MATCON Matrix Concatenation 
— se 


aah renames a —_———— ee 
(IN) x (TRANMATi)—gTEMPMATi where i is the row specified 
then at the completion of the multi- 
plication the TEMPMAT is normalized and the 16 most signi- 


by FSM2. If FSM2 = 3, 


ficant bits of each element placed in TRANMAT. 


LOAD 


— > —a : 


IN—gREGi where i is specified by the FSM fields of the RSR. 
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NC (perspective/viewport transformed)=NV, RB. 


A.2.3.8 STORE 
—> 


REGi-®PDP-11 Memory via DMA, where i is specified by the 
FSM fields of the RSR. 


keZa4 


Character Generator 


The Character Generator portion of the Picture System 
supplies x and y displacement data directly to the Picture 
Generator. The characters to be displayed are specified 
by ASCII codes that are passed unmodified through the 
Picture Processor and stored in the Refresh Buffer. 


The x and y data provided by the Character Generator is 
treated by the Picture Generator as relative vector draw- 
ing information. Therefore, the position at which a 
character string is to be displayed should be specified 
in the normal manner (i.e. 2DDRAW or 3DDRAW; MOVETO or 
DRAWIO) before the characters are output. 


The Scale Register in the Character Generator is used 

to specify the size of the characters to be drawn. This 
register is loaded using 2DDRAW or 3DDRAW STATUS commands. 
This section provides information relating the size of the 
characters to the screen coordinate systen. (Note: the 
screen coordinates range is ~2048 to 2047 as described 

in Section 5.2.1.3). 7 


The Character Generator contains character descriptions 
defined in screen coordinates. If the Scale x and Scale y 
portions of the Scale Register are both equal to 0 the 
smallest size is specified. This size character occupies 
an x space in the screen coordinate system that is 30 
screen units wide. It occupies a y space that ranges from 
+30 to -12 screen units, depending on the character . 
specified (lower case characters are the only ones that 
Bay occupy space in the negative direction; all upper case 
characters occupy the full +30 range). Figure A-4 shows 
the relative proportion of the upper and lower case 
smallest characters. 


It is important to note that the character definition in- 
cludes a MOVETO to the right boundary of the space it occu- 
pies in x to provide uniform spacing of characters. 


The Scale Register contains a bit that provides for the 
rotation of the character counter-clockwise 909, When this 
bit is set the range in scope units that the characters oc- 
cupy (at the smallest size) is -30 to +12 in x and +30 in y. 
The final MOVETO in the character defintion goes to the 

top boundary in this case. 


30 30 
SCREEN SCREEN 
UNITS _. UNITS 
“12 
SCREEN SCREEN 
UNITS UNITS | 


ve 30. 
et a 
; UNITS UNITS 


(2) 


Figure A-4 


Relative Character Sizes in Screen Units 
showing: (1) the Range of Upper Case Characters 
and {2) the Range of Lower Case Characters 
for the Smallest Size Characters. 


The Scale Register x and y scale fields 
pendent scaling of the height and width 
Table 1 shows the range in screen units 
the various sizes: 


Range in 
Screen Units 


Scale 

Value x x 
0 30 +30,-12 
1 60 +60,-24 
2 90 +90, -36 
3 120 +120,°48 
4 150 +150,-60 
5 180 +180,-72 
6 210 +210,-84 
7 
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provide for inde- 
of the characters. 
and inches for 


Range in 

Inches 

x 4 
+.07 +.07,-.03 
+.74 +.14,-.06 
+.21 +.21,-.09 
+428 +.28,°.12 
+.35 +.35,-.15 
+.42 +.42,-.18 
+.49 +.49,-.21 
+. 56 +.56,~. 24 


A.3 


PROGRAMMING THE PICTURE SYSTEM 


Sections A.2.1 and A.2.2 described the PDP-11 and Picture 
Processor registers which are used in programming THE PIC- 
TURE SYSTEM. The purpose of this section is to describe how 
these registers may be used to produce a program which inter- 
faces with the hardware at an assembly language level. 


Program Description 


To illustrate how to interface with THE PICTURE SYSTEM 
hardware, a Simple program will be described which displays 
a cube and allows the cube to be translated in x,y and z 
according to console switch settings, while displaying the 
characters "CUBE" which blink continually. However, in addi-~ 
tion to the details which this program will illustrate, the 
following points should be emphasized: 


l. The RSR Coordinate count (CNT) and the DMA word count 
(DRWC) must have corresponding values to ensure that 
the operation specified continues to completion. Exact- 
ly what the relationship is depends upon the command 
(COM) specified. The following shows the CNT/DRWE re- 
lation for each of the commands: (It should be noted 
that the CNT field of the RSR will contain the 
two's complement of the number of executions to be 
performed and the DRWC will contain the tvo's complement 
of the number of PDP-11 words to be transferred.) 


\ 


000-2DDRaAwW If FSM1 = MOVETO, DRAWTO or DOT: 
CNT «<@--(number of 16 bit word pairs) 
DRWC«=#— 2*CNT 
If FSM1 = STATUS OR CHARACTER 
CNT ~@--(number of 16 bit word triples) 
DRWC<@— 3*CNT 


00 1-3DDRAW CNT «@-(number of 16 bit word triples) 
DRWC<@#— 3*CNT 

010-PUSH CNT «-1 
DRwC—==® 0 

011-MATCON CNT «@--(number of rows to concatenate) 
DRWC—=@— 4*CNT 

100-POP CNT «--1 
DRWwC—@® 0 

101-LOAD CNT ~«@-(number of sequential registers 

to load) 


DRWC—@— 4*CNT 


110-STORE CNT <@-- (number of sequential registers 
to store) 


DRWC <& 4eCNT € 


111-NO OP CNT «@ 0 
DRWC=@®* 0 


It should be noted that when the Enable RSR Update 
function is used, the DRWC must be adjusted to account 

for each of the commands which will be executed and 

the RSRs which are embedded within the data. The NO OP 
command should be used as the last RSR within the RSR/data 
list. : 


2. Data which has been processed by the Picture Processor 
may be read back into the memory of the PDP~11 by using 
the STORE command and‘ addressing those registers where 
the data results are stored. These registers of inter- 
est are: 


ae SAVE Register: This will contain the transformed 
data coordinates before clipping was performed. 

b. New Clip (NC) Register: This will contain the 
transformed and clipped data coordinates if the 
most recent data resulted in an element which 
would normally be displayed. 

—cC.--New View (NV) Register: This will contain the 
transformed, clipped, and viewport mapped data 
coordinates if the most recent data resulted in | 
an element which would normally be displayed. 

d. Previous Clip (PC) Register: This will contain 
the transformed and clipped data coordinates of 
the computed beginning point of a line whose actual 
beginning point coordinates were clipped.- 

@. Previous View (PV) Register: This will contain 
the transformed, clipped and viewport mapped 
data coordinates computed of the beginning point 
of a line whose actual beginning point coordinates 
were clipped. 


The "hit bits" may be interrogated as described in 
Section A.2.1.4 to determine when the NC, NV, PC and PV 
registers contain meaningful information. 


3. Before a 2DDRAW or 3DDRAW command is performed (except 
STATUS and CHARACTER) the BASE Register (25 ) should 
be loaded with the constant z and w coordinates if 
2DDRAW or the constant w coordinate if 3DDRAW. This is 
done because the BASE register supplies the z and w 
coordinates for 2DDRAW commands and the w coordinate. 
for 3DDRAW commands. When the 2DDRAW command is used in 
conjunction with the STATUS or CHARACTER specification, 
three words will be accessed from the PDP-11, rather “~e 
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the two normally accessed for 2DDRAW commands. 


It should be noted that the STATUS words are deposited 
directly into the Refresh Buffer, and once a STATUS is 
encountered by the Picture Generator, the STATUS speci- 
fied will remain in effect (through subsequent frames 

when no STATUS is encountered) until an overriding STATUS 
is encountered. A STATUS command which does not have the 
TAKE bit (bit 11) set is considered to be a Refresh Buffer 


NO OP command, and hence does not affect the status of 
the Picture Generator or Character Generator. 


The structure of this sample program is consistent with the 
general structure of a PICTURE SYSTEM program as described 
in Chapter’ 5 of THE PICTURE SYSTEM User's Manual and shown 
in Figure A-5. The following section contains the MACRO-11 
assembly language listing of this program. A careful study 
of this program should clarify many of the topics covered 
within this appendix. The same program, but written in 
FORTRAN using the Graphics Software Package, is also shown. 


REFRESH 
INTERRUPT 


SET NEW 
FRAME BIT 


UPDATE OF __. 
DYNAMIC” > 
VALUES 


, CLEAR NEW: - 


FRAME FLAG 


RESTART 
RTC 


Figure A-5 


Sample Program Structure 


A.3.2 MACRO-11 Program Example 


FENDIX A: SAMPLE PROGRAM MACRO V@G-@3 O1-SEP-74 08:30 


3.2 OF CONTENTS 


oe ak DEFINITION OF REGISTERS AND COMMANDS 

eas DEFINITION OF CONSTANTS AND DAT 

am 2 PRIGSA INITIALIZATION 

Soi ad RTC INTERUS™ SERVICE ROUTINE 

oo” Ge TATA TO IMPUT? 

Ams FICTURE DISPLAY . 

ee Se EMA CUTRT ROUTINE 7 : 2 1. 


REPENDIX A: SAMPLE PROGRAM MACRO V@6-903 O1-SEP-74 @8:30 PAGE 1 
| 
i EVANS & SUTHERLAND COMPUTER CORPORATION ALL RIGHTS RESERVED ; 


; THIS SAMPLE PROGRAM DISPLAYS A CUBS ORTHOGRAPHICALLY WITHIN A 

j Neer) WHICH IS SP=ZCIFI=ZD AS THE Se SCREEN USING M&CRO-11 

2: CORT WHICH INTERFACES DIRECTLY WITH THE PICTURE SYSTEM. THE 

; CBE MaY BE TRANSLATED IN %, Y PND z BIRECTIONS DEPENDENT UPON 

> TRE CONSOLE DATS SYTTCH SETT INGS, ALL THE WHILE DISPLAYING THE 
CASRACTERS “CUBE WHICH Zi CONTINUALLY 


ae LN 4 Nae 


LA NE OT TE I GS A ES 


Dab mee te 
42 ; 
igs > CONSOLE SWITCH SETTINGS: 
os ; -SWTICH 25: SROGRAM RESTART 
— SWITCH 14: TRE NSLATE —x 
i) ; SWITCH 13: TRANSLATE -Y 
25 ; SWITCH 12: TRANSLATE -Z 
Le j SWITCH i2:, TRENSLATE +) 
a ‘ SWITCH 1O:) ee + 
ar Qo. 


. 
: 
ee 
. 


ee Ss} 


TRANSLATE +2 


ee P : 

Bo SSS FFE LEGS RETESET ess OTIS PSST SE SSS SST ee Ee ae SS SS 
22 7 

22 \ .TITLE APPENDIX A: S4°PLE PROGRAM 


IK A: SAMPLE PROGRAM 
TION QF Re: 


MACRO V@S-@3 @1-SEP-74 @8:30 PAGE 2 
GISTERS AND COMMANDS i fe, 3 


a -SRTTL DEFINITION CF REGISTERS AND CONMANDS 
bs 7 sats 
2 
3 BO2022 RQ 
ra OP 2E> Rt 
Ss 2EoaC >? R2 
3 el 23t2 23 
7 SIE A Req 
3 SCOBLS RS 
i S2IEOS S sp 
4c BI asF oa 
: fe ae id . 2 { 
¢2 RTCVEC =e3e200 iRTC INTERRUPT VECTOR 
AC, RTCPS =226z42 iRTC PROCESSOR STATUS (FOR INTERRUPT) 
45 LB77F3 27 ERIC REGISTER 
as LSP772 2: :SR REGISTER 
or, sary PS : Qen"STZ9 
bac: 1 Peats ; 52D COUNT REGISTER 
-3 272012 > ASE ADRESS REGISTER 
ao. ° OF PeA4 i Tee SEGISTER _ 
2: 2PP57 3 a 2 SaITCH REGIS 
2S O23 ae SiC COMVEND 
a4 B23 SIS COMMAND 
2= 373 as: 
ded S77 PNP 
ae eve MATCON CSPI 4 C2 CUS AT A TIME) COMMAND 
ar eis STATUS "SEAN, STATUS. ABS.) CO¥YEND 
2 LOADT™ STORYATION PATR_X COvvsnD 
ae Loapy. ea" Lb, 3B. COM 
at ye ROR, ey 4 
ee LOSSES REGISTER ¢ 


ASPENDIX &: SAMPLE PROGRAM 
DSS INITION OF CONSTANTS 4ND DATA 


: 
> S20220 
ec. 
a 
7 @20002 O40008 acoeee eoeose 
20635 999000 
© onesia 
ae 
DIT 


wy 


1 
© 
eeu 
“ 
& 
*) 
Aw 
is) 
8 
6%) 
© 


ii 


COE 23 3 
EZSGS CSOSA SAeses 
SOS? oe 
OLOLE S 
e BEBO SS 


SZIRCS = BeCADD 


MACRO V@6-03 @1-SEP-74 08:30 PAGE 32 


.SBTTL DEFINITION OF CONSTANTS AND DATA 


BEGIN: 
i IDENTITY MATRIX CDOISCONAL=d@@00 TO AVOID NORMALIZATION) 


IDENT: WORD 


3 TRANSLATION MATRIX 


TRNVST: WORD 4002¢,9,9,0 54SOO2 , COOCS.. ALOR, BOOED 


LORD = @, 429930, SQOOST,, COTO, PORWR’, SSE D 


WORD 29, 40202.9 jC2GAD, ALCLD, AVON, QOAS2. 

TX: WORD . @ i oT™, TY, Tz,.4eece 

7y: WORD @ 

ay a WORE ~— @, 40020 

INITIAL PICTURE GENERATOR STATUS 
(PGSTAT: .WORD 4017 ;SELECT ALL SCOPES, NO BLINK. NO DASH 
( WORE carr sSELECT -ORIZONTSL, LARGEST CHSRACTERS 

WORD 2 iFESERVET FOR COLOR USE 


3 BLINK STATUS 


BLNXON: .WORD  .4@37.2,@ iSELECT SLINKY AND ALL SCOPTS 
BUNKCF: WORD ¢217,9,8 iSELECT ONLY OL. scoPss 


i VIEWPORT SPECIFICATION CFULL SCSEEN, MAX DEPTS CUSING) 


VW_SH WORD ~2047.,255..0 


~2247., 
a 


VARTY: WORD Bed? .22@¢?.,2,0 


PENDIX 4: SAMPLE PROGRAM MACRO V@S-23 @1-SEP-74 08:30 PAGE 3-1 
= DEFINITION OF CONSTANTS SND DATA a oe eee oe 


27 ; BASE REGISTER vaLuss! 


— 
23 
“TZ L2Q%d2 CQERZD e2deeCe eBGERd ZWEese: WORD  @,2,2, 22767. 32-0, WaSe767. (% & Y DON’T COUNT) 
7 aay oy OeIBS > 
Sa Ont 4 ME ORE Cd : 
Ln 
a 3; VARIABLES AND LATA 
4D 
5 eeetse Bee SCTFT: WORD —-L2E99 . .-1 9000. 
w% 278156 e4e 125 (TEXT: ASCIT "CUSE? 
we 3 iz One 
os ae ote : 
- al errs. 
eS 2 <3 Soe BSD .BYTE (2.3,6,8 GFILL OUT THE COUNT TO SIX WITH a@’s 
: APL : 
‘ 4.2 PaFe CDATL: WORD 2248. ,2048.,-2048., +2242. ,2048.,-2648. 
AG : 
Lae 
i ae, i ry ! : a ‘ 
oF eee GRD 2968. , 2048. , 2048. , 20¢8 .,-2048. , -204 
ion a i . 
40 - WORD 2e¢3.,2648.,-2048., 206%.,2043.,20d2. 
2.2. Beas, WORD ~2949 .,20¢8.,2048., -2049.,-20¢8.,204¢8 
ate 
ae reat 
So Ceres ee Leer wR 2C48.,-SS42.,20dS., 22438.,2068.,2048 
QCLS.9 934202 yo 
SoS 17hOR8 | SOLE DE COAT2: WORD -29d9.,2943.,-2048., -22¢9.,28d5.,20¢9. 
. a Syn oe Oh a ae _ zee 5s 
a] era et Ae ted St, 5 ‘ 
Se 292202 fPeade ilPse2a -WORD -2O¢8 .,-2@48.,-2048., -2Z27¢3.,-2eds. , 2248. 
P29BID t7427R 7457465 BO ea ee : 
22 204e 41 7O8 23 Lee Se : : 
BS Ti RSLe O84 2 the 03 .w0RD 2O48 .,-2E43.,~-2963., 20°5.,-2845.,.20¢8, 
ni iTe4 S LPeteo a 
So L6o0le 2 NUF SAM: .WORD 2 
SE le 555 Caz > INCVAL: J WCRD Zee. 


OOPENDIX A: SAMPLE PROGSAM MACRO VOE-23 @1-SEP-7d 02:30 PAGE 4 
TENTS | 


-SETTL PROGRAM INITIALIZATION 


Soc S42 162727 BeCtel 167771? BISB HLLRTI+L iMASTER CLEAR THE PICTURE SYSTEY 
S iTHIS DOES THE FOLLOWING: 
? : SR <= 140021 


36 ODRNC <= 2 


© 
z : : 3 DREA <= 2 
a 3; DRST “= 2c2 
wets 3 CARTES Geshe 
Sei j 


ie . LOAD THE TRANSFORMATION MATRIX WITH TRE DDENTITY 


L= @203Se @127a¢ MoV sLOenTM, Sp : ;SET THE LOSS COMMAND 

it 212°e2 MOV - #-16.,52 316 KORTS TD BSE LOStcn 

ae C41 2782 MoV FTDENT, Re! )S=2T Tar BASE ADDRESS 

cd C@Q4A7E7 vER PC, DMAQUT. jASND SYS IT OUT ; 
3s ; 

2: . LOAD Tro VIEWPORT SND PASS REGISTERS 

Sa : 

a2 42eo7?7 MOV HLOADVL, RS _ SET TRE LOAD COMMAND CREGISTER 20) 
cs 17? 774 MCV H-4. 52 if WORTE TO BE LOADED 

ae CESLZ2? MOV SVAL3 5. 2 iSET Tet BASE ADRESS 

ze E@ettzZ JER Po. DYSOU7 3AND ONC IT OUT 

pag 3 J 

ae Micy SLOAD YE, TS beat Ns T= WOSD COMNAND CREGTSTE2 2d) 
ey eats #—4.,3t 34 WORDT TO BE LORDES 

fae ov EVAR SE iSET TRE PASS SDPRSSS 

oe JER Pose hee” pAND Ses UT OST 

Se F 

=z “IO 12723 Moy SLOS3DES, Se iSET THE LSD COMMAND (REGISTER 25) 
es 6 GLSPRt MoV sok FL 94 WORTS US FE LOADED 

Zs OU | OLLI * Rov sewBosl. = ;SET Tec DASE ADDRESS 

Se ides betes MOL IF JS SC. O¢anU? 5480 TeS 2T QUT 

2s , 


“7 > NOTE: REGISTER 25 COULD HAVE BEEN LO CDID HEN REG! 
ray 


ae ER 2c Was 
pea j LOADED BY LELREMENTING THE RSX CNT BY 4 T 


TING “FE 


ze F DRWC TO TSENSTER 4 MORE NORES 

ae : 3 : 

at ; ; 3 SET THE INITIAL PICTURE GENERATOR STATUS - 
6a ‘ 


~c S@ 212700 022377 MoV FETT OS. RS GSET TRE STATUS CONMAND 
44 O30652 CLe7SE LPF F7S : MCV Eso oer 32 WORDS TO BE OUTFIT 
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APPENDIX B 


SUMMARY OF THE GRAPHICS SUBROUTINES 


This appendix contains a summary of the FORTRAN AND MACRO-11 
assembly language calling sequence specifications for THE PICTURE 
SYSTEM Graphics Subroutines. Also included is Table B-1, which 
summarizes the Graphics Subroutines Error Codes. This code is 
used to indicate the subroutine which detected a user error 
should one occur. 


TABLE B-1 
SUBROUTINE ERROR CODE CORRESPONDENCE 


SUBROUTINE NAME ERROR CODE} 


PSINIT 1 
NUFRAM 2 
VWPORT 3 
WINDOW, MASTER 4 
INST 5 
PUSH 6 
POP 7 
TRAN 8 ° 
ROT 9 
DRAW2D 10 
DRAW3D 11 - 
TEXT. os BS ee 12. «:, 
TABLET 13 . 
CURSOR © : 14 Mee ad 
HITWIN | 15 a 
HITEST =. 16 
SCALE °° 7 _ 
CHAR | a 18 
DASH? =.) 19 

BLINK... =. 20 

‘ SCOPE a 21 Se ae 

SETBUF 22 
BLDCON 0 


lif an error occurs that is detected by cone of these sub- 
routines, then the error code will indicate which subrou- 
tine the error was detected in. 


Be 1 


FORTRAN CALLING SEQUENCES: 


[ EXTERNAL ERRSUB ] 


CALL 


CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 


PSINIT ([FTIME,INRFSH,[ ICLOCK },[ ERRSUB ],{ ISTKCT ], 
{ ISTKAD |{ , IFMCNT }) 

VWPORT (IVL,IVR,IVB,IVT,IHI,IYI) 
WINDOW (IWL,IWR,IWB,IWT[ ,IW }) 

WINDOW (IWL,IWB,IWT, LWH,IWY[,IE{, IW ]]) 
ROT (LANGLE, IAXIS) 

TRAN (ITX,ITY,ITZ[ ,1W J) 

SCALE (ISX, ISY,ISZ[, THT) 

PUSH 

POP 

DRAW2D (IDATA, INUM, IF 1,1F2,12Z[,IW ]}) 
DRAW3D(IDATA, INUM,IF1,IF2[ ,IW }) 

CHAR (IXSIZE, LYSIZE, ITILT) 

TEXT (NCHARS , ITEXT) 

INST (INL, INR,INB,INT[ , IW ]) 

INST (INL, INR,INB, INT, INH, INY[ , IW }) 
MASTER (IML, IMR,IMB,IMT[,IW]) | 
MASTER (IML, IMR, IMB, IMT, IMH,IMY[,IW ]) 
DASH (ISTAT) 

BLINK (ISTAT) i 
SCOPE (INUM) 

TABLET (ISTAT[ ,1X,IY, 1PEN }) 

CURSOR (LX, LY, ISTAT[ , IPEN }) 

HITWIN (IX,1Y,ISIZE{ , IW }) 

HITEST (IHIT,ISTAT) 

NUFRAM _ 

SETBUF (ISTAT) 

PSWAIT 

BLDCON (ITYPE, TARRAY) 


ASSEMBLY LANGUAGE CALLING SEQUENCES 


All subroutines should be declared global {.GLOBL). All. 
arguments are addresses of parameters. 


PSINIT 


MOV #ADR,RS 
JSR PC,PSINIT ; 

ADR: BR «+14. 
WORD IFLTIME,INRFSH, ICLOCK, ERRSUB,ISTKCT,ISTKA 

Or 
MOV #ADR,RS 
. JSR PC, PSINIT 

ADR: BR «+16. 

~WORD IFTIME,INRFSH,ICLOCK, ERRSUB,ISTKCT,ISTKAD,IFMCNT 


MOV #ADR,RS | 
JSR PC,VWPORT. 

ADR: BR .#14. on: es 
'.WORD IVL,1IVR,IVB,IVI,IHI,IYI..-. 


MGV #ADR,R5 > core Te 

JSR PC,WINDOW! 2 0 hey tee. 
ADR: BR -+10. _ 

-WORD IWL,1WR,IWB,IWT 


MOV #ADRB,RS 
JSR PC,WINDOW 
ADR: BR ~+12. 
-' WORD IWL,IWR,IWB,IWT,IW 


MOV #ADR,R5 
JSR PC, WINDOW 
ADR: BR +14, 
~WORD IWL,IWR,IWB,IWI,IWH,IWY 


MOV #ADR,R5 
JSR PC, WINDOW 
ADR: BR +16. 
~WORD IWL,IWR,IWB,IWT,IWH,IWY,IE 


MOV #ADR,RS.. 
JSR PC, WINDOW 
ADR: BR +18. ; 
-WORD IWL,IWR,IWB,IW? ,IWH,IWY,IE,iW 


MOV 
JSR 
ADR: BR 
- WORD 
ERAN 
MOV 
JSR 
ADR: BR 
- WORD 
or 
MOV 
JSR 
ADR: BR 
«WORD 
SCALE 
MOV 
JSR 
ADR: BR 
. - WORD 
or ha 
MOV 
JSR 
ADR: BR . 
- WORD 
PUSH 
JSR 
POP 
JSR 
DRAW2D 
MOV 
JSR 
ADR: BR 
«WORD 
Or 
MOV 
JSR 
ADR: BR 
- WORD 


#ADR,R5 
PC,ROT 

- +6. 
IANGLE,IAXIS 


#ADR,R5S 
PC,TRAN 
+8. ss 
ITX,ITY,1T2Z 


#ADR,RS5S 

PC, TRAN 

-+10.. 
ITX,1TY,ITZ,1IW 


#ADR,RS5 
PC,SCALE | 
ot8. 

ISX, ISY,1SZ 


#ADR;R5 


— PC,SCALE ~ | 


- +10. ae ns ewe pdb 
ISX,ISY,1SZ,I 


PC, PUSH 
PC, POP 


#ADR,RS5 

PC, DRAW2D 

+12. 

IDATA, INUM,IF1,IF2,1Z 


#ADR,R5 

PC, DRAW2D 

+14, 
ICATA,INUM,IF1,IF2,1Z,1W 


ADR: 


#ADR,R5S 

PC, DRAW3D 

+10. 

IDATA, INUM,IF1,IF2 


#ADR,R5 

PC, DRAW3D 

~ +12. 
IDATA,INUM,IF1,IF2,1W 


#ADR,R5 

PC,CHAR 

- +8. 
IXSIZE,ITYSIZE,ITILT 


#ADR,R5. 

PC, TEXT. 
ot6, 0° 
NCHARS,ITEXT 


#ADR,R5 
PC,INST 
-+10. 
INL, INB,INB,INT 


 $ADR,RS : 


PC, INST 
+12. : 
INL, INR,INB,INT,IW 


#ADR,B5 

PC,INST 

o~t14,. 

INL, INR,INB, INT, INH, INY 


#ADR,R5 

Pc, INST 

- +16. 

INL, INR,INB,INT,INH,INY,IW 


MASTER 
MOV #ADR,R5S 
JSR PC,MASTER 
ADR: BR +10. 
~ WORD IML,IMR,IMB,IMT 


MOV #ADR,R5S 
JSR PC, MASTER 
ADR: BR ot1Zs 
-WORD IML, IMR,IMB,IMT,IW 


MOV #ADR,R5 
JSR PC, MASTER 
ADR: BR eo +14, 
~WORD IML,IMR,IMB, IMT, IMH,IMY 


MOV #ADR,B5 
JSR PC, MASTER 
ADR: BR +16. 
WORD IML, IMR,IMB,IMT,IMH ,IMY,IW 


MOV.. #ADR,RS 
' JSR. PC,DASH 

ADR:: BR «+4. 

-WORD ISTAT | 


MOV #ADR,R5 
~ JSR PC, BLINK 
ADR: BR o +4. 
~WORD ISTAT 


SCOPE 
MOV’ #ADR,R5 
JSR PC,SCOPE 
ADR: 5R - +4, 
-WORD INUM 
TABLET 


MOV #ADR,RS 

JSR PC, TABLET 
ADR: BR 2 +4, 

eWORD ISTAT 


ISR 
ADR: BR 
. WORD 
CURSOR 
MOV 
JSR 
ADB: BR 
. WORD 
Or 
MOV 
«JSR 
ADR: BR 
. WORD 
HITWIN 
MOV 
JSR 
ADR: BR 
.°.. SWORD 
Or 
MOV 
JSR 
ADR: BR 
. WORD 
HLTEST 
MOV 
JSR 
ADR: BR 
. WORD 
NOFRAM 
JSR 
SETBUF 
NOV 
JSR 
ADR: BR 
. WORD 
PSWAIT 
JSR 


#ADR,R5 
PC, TABLET 
- +10. 


ISTAT ,IX,1Y,IPEN 


#ADR,R5 
PC,CURSOR 
IX,1Y,iISTAT 


#ADR,RS 
PC, CURSOR 


IX, 1IY,ISTAT,IPEN 


_#ADR,R5 


PC, HITWIN 
+8. : 


IX,1Y,ISIZE | 


#ADR,R5 
PC, HITWIN 
-+10. 


IX,1TY,ISIZE,1W 


#ADR,RS5 

PC, HITEST 
- +6. : 
ITHIT, ISTAT 


PC,NUFRAM 


#ADR,RS 
PC,SETBUF 
- +4, 
ISTAaT 


PC, PSWAIT 


MOV #ADR,R5 
JSR PC,BLDCON 


ADR: BR « +6. 
~WORD ITYPE 
~WORD IARRAY 
PSDMA 
RO = Repeat Status Register 
R1 = DMA Word Count 
R2 = DMA Base Address 
JSR PC,PSDMA 
LSMATX 
JSR PC,ISMATX 
ERROR 
“JSR PC,ERROR.. 
- BYTE ICODE,IERR ~ 
P$DIV 
RO,R1 = Dividend 
R2 ° = Divisor 
JSR PC,PS$DIV. 
PSMUL 


RO Multiplicand 
R2 Multiplier 
JSR PC,PSMUL 


(RSR) Value 


APPENDIX C 


PDP-11 FORTRAN CALLING SEQUENCE CONVENTION 


INTRODUCTION 


This calling sequence convention is compatible with all 
PDP-11 processor options, (including use of distinct 
Instruction and Data Space capabilities of the KT-11D 
Memory Management Option), provides both reentrant and 
Nnon-reentrant forms, and is as fast and short as possible, 
consistent with these requirements. 


This description is oriented toward the programmer who 
vishes to write assembly language routines which can be 
Called by or which call FORTRAN-compiled routines. This 
calling convention is completely ccmpatible with the 
Threaded Polish code of the FORTRAN Compiler V06, though 
the assembly language programmer need not be concerned 
with or use the Polish technique or service routines. 


THE CALL SITE 
The basic form of the non-reentrant out of line call is: 


; INSTRUCTION SPACE | 
HOV #LIST,R5 ; ADDRESS OF ARGUMENT LIST 
a. 30 REGISTER 5 


; IN DATA SPACE 


LIST: ~BYTE N,0O ;NUMBER OF ARGUMENTS 
» WORD ADR 1 . 7 FIRST ARGUMENT ADDRESS 
ios ADRN sN'TH ARGUMENT ADDRESS 
ADRI1: ios ; s;FIRST ARGUMENT 
ADRN: — : a AEGUMENT 


RETURN 


Control is returned to the calling program by restoring 
(if necessary) the stack pointer to its value on entry and 
executing: 


RTS PC 


RETURN VALUE TRANSMISSION 


FORTRAN FUNCTION subprograms will. return the function 
value in general register RO through R3 aS appropriate to 
the type as follows: 


BYTE (LOGICAL*1), RO 
LOGICAL, INTEGER 
REAL RO, R1 


DOUBLE PRECISION RO, R1, R2, R3 
REAL COMPLEX 


The only difference between a SUBROUTINE subprogram and a 


FUNCTION subprogram is that a FUNCTION returns a value in 
the general registers. 


CONTEXT SAVE AND RESTORE CONVENTION 


A calling program must save any values in general purpose 
registers RO through R4Y, which it requires after a return 
from a subprogram. The argument list pointer value in 
register R5 may not be assumed to be valid after return. 


NON-REENTRANT EXAMPLE 


In non-reentrant forms, the argument list may either be 

placed in line with the call or be placed out of line in 

an impure data section. (The latter is recommended and 
illustrated here.) Figure C-1 illustrates the assembly 
language code to implement a small FORTRAN FUNCTION subprogram 
using the non-reentrant form of call. .Note that the non- 
reentrant form, is shorter and generally faster than the 
reentrant form since addresses of simple variables can be 
assembled into the argument list. 


FNC: 


INTEGER FUNCTION FNC(I,J) 
INTEGER FNC1 


FNC=FNC (I+J,5) +I 


RETUBN 
END 
-CSECT 
-GLOB FNC, FNC1 oy 
MOV... '  -R5,-(SP) ;SAVE ARG LIST POINTER 
MOV. @2(R5) ,- (SP) ;FORM I+J ON STACK 
“ADD. O . @4(R5),@SP 
MOV. - SP, LIST+2 s ADDRESS OF I+J TO 
. - : :ARG LIST 
MOV - #LIST,R5 . te 
JSR. PC, FNC1 as . r= 
ADD | #2,S5P . ;DELETE TEMPORARY I+tJ 
MOV (SP) +,R5 sRESTORE R5 
ADD @2 (R5) ,R0 - 3ADD I TO FNC1 RESULT 
RTS PC ;RETURN VALUE IN RO 

;DATA AREA 
-BYTE 2,0 ;TWO ARGUMENTS 
- WORD 4) ; DYNAMICALLY FILLED IN 
- WORD LITS5 ; ADDRESS OF CONSTANT 5 
«WORD 5 sCONSTANT 5 
- END 

Figure C-1 


Example Call Sequence Convention Usage: Non-Reentrant 


FNC: 


CONS: 


REENTRANT EXAMPLE 


The PDP-11 FORTRAN calling convention also has a reentrant: 
form in which the argument list is constructed at run-time - 
on the execution stack. Note that the argument addresses 
must be pushed on the stack backwards in order to be correctly 
arranged in memory for the subroutine that references the oe 


list. Basically it consists of: 
MOV #ACDRn,- (SP) ; ADDRESS OF NTH ARGUAENT 
MOV #ADR2- (SP) 
MOV #ADR1- (SP) sADDRESS OF 1ST ARGUMENT 
MOV #N,- (SP) 3; NUMBER OF ARGUMENTS 
MOV SP,R5 
JSR PC, SUB sCALL SUBROUTINE 
ADD #2*N+2,SP ; DELETE ARGUMENT LIST 


Figure C-2 illustrates assembly language code using reentrant 
call forms. for the same example shown in Figure C~1. 


INTEGER FUNCTION FNC (I,3) 
INTEGER FNC1 


-PNC=ENC1 (I+d,5)4I_ 


RETURN 
END 
2 SCECT 
~GLOBL FNC,FNC1 
MOV R5,- (SP) 
SOV @2 (R5) ,- (SP) ;SAVE ARG LIST POINTER 
ADD @4(R5) ,-@SP ; FORM I+J 
MOV SP,R4 ; REMEMBER WHERE 
MOV #CON5,- (SP) ;BUILD ARG LIST ON STACK 
MOVY R4,-(SP) ; ADDRESS OF TEMPORARY 
MOV #2,-(SP) ; ARGUMENT COUNT 
MOV SP,R5S ;ADDRESS OF LIST TO R5 
JSR PC, FNC1 sCALL FNC1 
ADD #10,SP ; DELETE ARG LIST AND TEMP I+J 
MOVYV (SP) +,85 ; RESTORE ARG LIST POINTER 
ADD @2(R5) ,RO sADD I TO RESULT OF FNC1 
RTS PC ; RETURN RESULT IN RO 
; DATA AREA 

eWORD 5 
«END 

Figure C-2 


Example call Sequence Convention Usage: 


Reentrant Forn 


Note that the list must reside in Data-space and that 
except for label type arguments, all addresses in the 
list must also refer to Data-space. 


Also note that the byte at address LIST+1 should be 
considered undefined and not referenced. (Use of 
this byte is reserved for use as defined by DEC.) 


fhe basic form of the non-reentrant in line call is:} 


- IN INSTRUCTION/DATA SPACE 


MOY #LIST,RB5 ; ADDRESS OF ARGUMENT LIST 
3TO REGISTER 5 
- JSR PC, SUB >CALL SUBROUTINE 
LIST: BR 2 +2¥*N+2 ; BRANCH AROUND 
; ; PARAMETER LIST 
« WORD ADR1 ; FIRST ARGUMENT ADDRESS 
«WORD ADRN ;N'TH ARGUMENT ADDRESS 


. ; IN DATA SPACE 
ADR1: - WORD 1 ; FIRST ARGUMENT 


ADRNS - WORD N ;N'TH ARGUMENT 


Note that the byte at address LIST will contain the value 
N and that the byte at address LIST+1 will contain the 
Value 1. 


ithis form of call is not compatible with distinct use 
Instruction and Data Space Capabilities. 


of 


. NULL: ARGUMENTS 


Null arguments are represented in an argument. list. by 
using an address of -1 (177777 octal). This. address 
is chosen because it is easy to test for and also to 
assure that the use of null arguments, in subroutines 
that are not prepared to handle them, will result in 
an error when the routine is called at execution time. 
The errors most likely to occur are illegal memory 
reference and/or word reference to odd byte address. 


Note that null arguments are included in the argument 
count as shown in Figure C-3. 


FORTRAN statement Resulting Argument List 

CALL SUB «BYTE 0,0 

CALL SUB ( ) ~BYTE 1,0 
7 - WORD -1 

CALL SUB (A,) - BYTE 2,0 
. -~WORD A 

~WORD -1. 

CALL SUB (,B) - “) BYTE 2,0 = : 
: ~WORD -1 
~WORD B 
Figure C-3 


Example Argument Lists with Null Arguments 


APPENDIX D 


USE OF THE GRAPHICS SOFTWARE WITH 
e THE PAPER TAPE SOFTWARE SYSTEM 


D.1 DESIGN AND USE OF THE PAPER TAPE GRAPHICS SOFTWARE 
PACKAGE 


The Paper Tape Graphics Software Package was desiqned to 
execute in a minimal memory configuration and yet provide 
user flexibility in using only those subroutines necessary 
for a particular application program, allowing a maximum 
memory availability for the application program and data 
base. This was done in the following manners 


THE PICTURE SYSTEM initialization subroutine (PSINIT) 
is written as an absolute program to be loaded ata 
fixed location in memory. This subroutine contains 
all the system level software required to interface 

to THE PICTURE SYSTEM, as well as all global constants 
and variables that are used for intercommunication © 
between subroutines. Since PSINIT is written as an | 
absolute routine, all references to these qlobal 
constants and variables may be made to an absolute 
location. 


Siete All other subroutines are in position independent 
So code! (i.e., may be loaded and executed anywhere in 

memory). This allows a user to load only those 
subroutines necessary for a particular application. 
by utilizing a feature of the PDP-11 Absolute Loader?. 
This feature is the ability to load a routine fron 
the last location loaded previously by the loader. 
Using this technique, the user may load those routines 
necessary in any order, ensuring that the minimum core 
required will be taken. 


All PICTURE SYSTEM Subroutines must have a Transfer Vector 
linkage of the form shown in Figure D-1. 


TReference PDP-11 Paper Tape Software Programming Handbook 
DEC-11-XPTSA-A-D,Chapter 6. 


2Ibid, Chapter 9.1. 


lst word: 167754, (subroutine identifier) (="PI+"CS+¢"Ys) 


2nd word: Relative location of last word of routine 
ak from Ist word ; 


3rd word; . . Subroutine identifier (=relative location to 
_ PSINIT in Transfer Vector) 


4th words : Relative location of subroutine entry point 
' from lst word ~~ 


nth word:  — -1 (if last entry point, otherwise same as 
words 3 and 4 above for subroutines with 
multiple entry points?!.) 


- Figure D-1. 


PICTURE SYSTEM Graphics Software Package 
Subroutine Heading Format 


1Refer ence listing of subroutine CHAR for example. 


D.2 ERRORS USING THE BASIC TAPE SOFTWARE PACKAGE 


Errors that occur during use of the Paper Tape PICTURE SYSTEM 
Graphics Software Package may be of two types: 


S a. User Software Errors 
b. Eguipment Failure (Hardware Errors) 


The conditions that may cause these errors are as follows: 


A user may make five programming errors that will be detected 
by the Graphics Software Package. These are: 


1. The call of a routine which has not been loaded 
(or loaded properly) into memory. 
2. The call of a routine with an invalid number of 
parameters specified. 
3. The call of a routine with an invalid parameter value. 
4. The attempt by a user to PUSH a transformation to a 
depth greater than that specified by the user. 
5. The attempt by a user to POP a matrix that 
had not been previously PUSHed. 


Error detection results in the following for errors 1-5 above: 


Upon the call of a routine which has not been loaded 
into memory, a halt will occur at location 276 (show- 
6} ing 300 in the console data lights). The user then 
may determine the origin of the "invalid" call by 
examining the last element on the stack as pointed to | 
by Register 6 (SP). 


Error 2: 

Upon the call of a routine with an invalid number of 
parameters, the user's error routine (as specified in 

call to PSINIT) will be called using the standard FORTRAN 
calling sequence and a parameter indicating the origin 

of the error detected (see Figures D-2 and D-3) will 

be passed. If the user's error routine has not yet been 
established, then a halt will occur at location 2761 (showing 
300 in the console data lights). The error code may then be 
determined by examining the location pointed to by 

the second from last element on the stack (SP-4) as 

pointed to by Register 6 (SP). Return from the 

user's error routine will result in a halt occuring at 
location 276. 


1It should be noted that if the user's error routine has not yet been 

established by PSINIT, then the programmer will be unable to discern 
the difference between Error 1 and Errors 2,3,4,5 without a detailed 
knowledge of the position of the routines in memory. 


i] D-3 


FIGURE D-2 


SUBROUTINE INFORMATION 


Stack2 
Subroutine Vector Lengthl- Length! Space.:.- Registers - 
Name. Offset,, Bytes,, Bytes, Required Destroyed Error Codes_& Meaning 
1 PSINIT 0 1846 3466 30 None 1,O0-Invalid No. of Parameters 
a 1, 1-Invalid Parameter 
: . 1,2-Direct Memory Access Error 
2. NU FRAMS 4 (1) (1) Dex None None 
3. VWPORT 8 (1) (1) 16 None 3,0-Invalid No. of Parameters 
4%. WINDOW 12 498 762 38 None 4, O-Invalid No. of Parameters 
5. INST 16 (4) (4) . 36 None 5,0-Invalid No. of Parameters 
6. PUSH 20 (1) (1) 20 None 6,0-PUSH Error 
7. POP 24 (1) (1) . 20 None 7,0-POP Error 
8. TRAN 28 150 226 28 None 8,0-Invalid No. of Parameters 
9. ROT 32 386 602 30 None 9,0-Invalid No. of Parameters 
7 9, 1-~Invalid Parameter 
10. SCALE 64 138 212 28 None 17,0-Invalid No. of Parameters 
11. DRAW2D 36 260 404 20 None 10,0-Invalid No. of Parameters 
10, 1-Invalid Parameter 
12. DRAW3D 40 (11) (11) . 20 None 11,0-Invalid No. of Parameters 
! 11, 1-Invalid Parameter 
13. TEXT ree 188 274 18 | None 12,0-Invalid No. of Parameters 
14. TABLET 48 188 274 “16, - None 13, 0-Invalid No. of Parameters 
15. CURSOR 52 440 662 — 76 None 14,0-Invalid No. of Parameters 
16. HITWIN 56 276 422 . 32 None 15, 0-Invalid No. of Parameters 
17. HITEST 60 (16) (16) 20 None 16, 0-Invalid No. of Parameters 
18. PSWAIT 72 (1) (1) 2 None None 
19. CHAR 76 258 402 16 None 18,0-Invalid No. of Parameters 
20. DASH 80 (19) (19) 16 None 19,0-Invalid No. of Parameters 
21. BLINK 84 (19) (19) ~ 46 None 20,0-Invalid No. of Parameters 
22. SCOPE 88 (19) (19) 16 None 21,0-Invalid No. of Parameters 
23. SETBUF 68 80 98 2. None 22,0-Invalid No. of Parameters 


22-1-Invalid Parameter 


1The numbers in these columns within parenthesis (i.e.,(1) }) indicate that the subroutine is 
“included as part of the subroutine whose number islin parenthesis. 

2This column indicates the number of bytes of stack space that must be available when this 
subroutine in called (includes the call). Po. 


i 


Subroutine Vector 
Name. ____s—“‘é ES, 
BLDCON (1) -4 
RSTORE -8 
P$AVE -12 

I$ MATX - 16 
P$DMA ~20 
ERROR -24 
P$DIV -28 

P$ MUL Lo Wee 


Length? 


Bytes, , 


(1) 
(1) 
(1) 
(1) 
(1) 
(1) 
(1) 
(1) 


FIGURE D-3 


Length! 
Bytes, 


(1) 
(1) 
(1) 
(1) 


(1), 
1) 


(1) 
(1) 


Stack? 
Space). 
Required 


18 
2 


14 


SYSTEM LEVEL SUBROUTINE INFORMATION. 


Registers 
Destroyed 


None 


RO-B&5 


None 
RO, R1,-R2 
None 
None 
RO,R1 


RO,81 


0,0-Invalid No. of Parameters 
0,1-Invalid Parameter 
None 


None 

None 

Halt at Location 272 
Direct Memory Access Error 


Branch to User Error Routine 
or Halt at Location 276 


Overflow set on Error 


None 


ifthe numbers in these columns within parenthesis {i.e.,(1) ) indicate that the subroutine is 
included as part of the subroutine whose number is in parenthesis. 
2This column indicates the number of bytes of stack space that must be available when this 


subroutine is called (includes. the call). 


} 


Error 3: 
Same as Error 3 (Parameter error) 


Ercor_4: 


Same as Error 2 (Push error) 


Error_5: 


Same as Error 2 (Pop error) 


a ere ee en ee kh re Sn ee et ee ee Se 


detection of hardware errors is to a minimal level, within 

the Graphics Software Package. The only error that may be 
detected is a DMA error which will result in a halt occuring 

at location 272 (showing 274 in the console data lights) 

If this occurs, it indicates a failure in the Digital Equipment 
Corporation DR-11B DMA unit. However, other errors may 

occur as a result of a hardware malfunction or a general 
programming problem. These errors will result in a halt 
occuring at a’ location in memory. These halt locations are 
Summarized in Figure D-4, 


HALT LOCATION, QOR_ 

000006 (000010) Time Out 

000012 (000014) 2 _.._.-«~<Illegal & Reserved Instructions 

000016 (000020): : BPT 

000022 (000024)! IOT 

000026 (000030)! Power Fail/Auto Restart 

000032 (000034) 1 EMT 

000036 (000040) 2 TRAP 

000272 (000274)1 DMAECLor 

000276 (000300) 1 Non-Existant Program Error 
FIGURE D-4 


Paper Tape PICTURE SYSTEM Graphics Software Package 
Halt Locations : 


eee ees ae 


‘Location (xxxxxx) is the location shown in the console data 
lights when the halt occurs. 
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PROGRAMMING THE PICTURE SYSTEM USING THE PAPER TAPE 
SOFTWARE PACKAGE 


Programs written for use with the Paper Tape Software Pack- 
age use the same general program structure and techniques 
as described in Chapter 5. The user, however, has the 
additional responsibility of: 


1. Defining the Linkage to the graphics subroutines. 

2. Initializing the program stack pointer (register 6) 
to the reserved stack area. 

3. Ensuring that the program does occupy the sane 
area of memory as the graphics software. 


The linkage to the graphics subroutines is provided by 
equating the entry in the transfer vector to the subrou- 
tine name as defined in Figure D-2. This method allows 

the subroutines to be referenced symbolically and also 
make the program upward compatible with all DEC operating 
systems by simply replacing the equate with a global symbol 
definition (.GLOBL). ‘Figure D-5 illustrates the manner 

in which the transfer vector entries are equated with the 
graphics subroutines. 


An area of memory is reserved for the program stack area. 
beginning at 620s and extending through 400 in memory as 
Shown in Figure D-6. The stack pointer to this area must, 
however, be initialized by the user's program before any 
subroutines are called or any interrupts occur. Figure 
D-5 shows a typical manner in which this may be done. 


fhe user must ensure that his program's starting address 
does not overlap an area of memory where a graphics sub- 
routine resides. To do this the user must total the lengths 
of all of the graphics subroutines used (Figure D-2) and 
position his program above that area of memory by using 

the ".= start address" notation of the DEC assemblers. Fig- 
ure D-5 illustrates this. 


Except for these three additional responsibilities, the 
user is free to utilize all of the capabilities of the 
graphics subroutines without constraint in the Paper Tape 
environment. 


1See 


eference 3, Part 3, Chapter 2, Monitor Keyboard 


Commands, for specific details. 


TS$VECT =1000. 


PSINIT =T$VECT+0. 
NUFRAM =T$VECT+4, 
VWPORT =TSVECT+8. 
WINDOW =TS$VECT+12. 
INST =T$VECT+16. 
PUSH =TS$VECT+20. 
POP =TSVECT+24, 
ROT =T$VECT+32. 
TRAN =T$VECT+28. 
SCALE =TSVECT+64. 
DRAW2D =T$VECT+36. 
DRAW3D =TSVECT+4O. 
TEXT =TSVECT+U4. 
TABLET =T$VECT+48. 
CURSOR =TSVECT+52. 
HITWIN  =T$VECT+56. 
HITEST =T$VECT+60. 
PSWAIT =T$VECT+72. , 
CHAR " =T$VECT+76. = 
DASH =T$VECT+80. 
BLINK =T$VECT+B4, 
SCOPE § =T$VECT+88. 
SETBUF =T$VECT+68. 
. : 
BLDCON  =T$VECT-4.. 
3 | i 
STACKP =620 
; 
-=7770 | | «-s« SET THE PROGRAM START ADDRESS 
STOP: TST (R5) + ; A USER ERROR SUBROUTINE 
MOV ® (R5) ,RO 3; MOVE THE ERROR CODE TO RO 
HALT ; AND HALT 7 
; 
i 4 
START: MOV #STACKP,SP 
° 
; INITIALIZE THE PICTURE SYSTEM 
MOV #.+8.,R5 
JSR PC,PSINIT 
BR .+14. 
. WORD THREE, ZERO,-1,STOP,-1,-1 


Figure D-5 
User Responsibilities in the Paper Tape Software System 


4k 


000 
INTERRUPT VECTORS -$ 128,9 WORDS 


400 
402 


620 


PICTURE SYSTEM 
TRANSFER VECTOR 


PSINIT 

RTCINT 

BLOCON 
ETC. 


OTHER PICTURE SYSTEM 
SUBROUTINES AS REQUIRED 


OTHER PICTURE SYSTEM 
SUBROUTINES AS REQUIRED 


OTHER PICTURE SYSTEM 
SUBROUTINES AS REQUIRED (VARIABLE) 


USER SPACE 


ae see seid 
rf 10 ORDS 
(OPTIONAL) 3498 
17474 
ABSOLUTE LOADER Lala 729 WORDS 
17744 
BOOTSTRAP 7742 tao Wicnbs 
Figure D-6 


Typical PICTURE SYSTEM Paper 
Tape Memory Configuration (4K) 


APPENDIX E 


USE OF THE GRAPHICS SOFTWARE WITH THE 
DOS/BATCH DISK OPERATING SYSTEM 


USE OF THE GRAPHICS SOFTWARE PACKAGE 


The Graphics Software Package is available to the 
DOS/BATCH user as a library of catalogued object Modules 
which may be linked with the user's FORTRAN! or MACRO-112 
Program to form graphics application programs. The 
PICTURE SYSTEM Graphics Library (PICLIB), which contains 
all of the subroutines described in Chapter 4, is searched 
by the linker (LINK)3 to load those subroutines called 

by the user program. The resulting program forms a 

load module (LDA format) which may be executed upon 

user demand. 


Part 7. 
2D0S/BATCH AsSembler (MACRO), Reference 3, Part 6. 
3DOS/BATCH Linker (LINK), Reference 3, Part 9. 
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USE OF PDP-11 FORTRAN IV WITH THE PICTURE SYSTEM 


DOS/BATCH FORTRAN conforms to the specifications for | 
American National Standard FORTRAN and is also highly 
compatable with IBM 1130 FORTRAN. DOS/BATCH FORTRAN 
programs can be compiled and run on any PICTURE SYSTEM 
configuration that support the DOS/BATCH Operating 
Systen, and which has a minimum of 16K of memory. 
DOS/BATCH FORTRAN supports all standard hardware options 
Supported by the operating system. 


Graphics applications programs written using FORTRAN 
interface to THE PICTURE SYSTEM by means of the sub- 
routines contained in the Graphics Library (PICLIB). 

All FORTRAN statements and functions are available 

to the user of THE PICTURE SYSTEM; however, the following 


' should be stressed to the PICTURE SYSTEM FORTRAN user: 


1. All parameters passed to the subroutines 
of the Graphics Library are integers. Should 
a REAL parameter be passed as a parameter to 
a graphics subroutine, the sign, binary excess 
128 © exponent . and high- “order mantissa will be 
treated as. an integer. 


2. ‘The “one enrd integers" switch {/ON) should 
be. ‘specified to the FORTRAN compiler to ensure 
that the elements ‘Of integer arrays are 
contiguous in memory as required by the 
GEapRECs software. 


.Figure E-1 outlines the steps reguired to prepare 


a FORTRAN source program for execution under the 
DOS/BATCH monitor: (1) Compilation, (2) Linking 
and (3) Execution. 


FORTRAN LIBRARY 
(F TNLIB) 
GRAPHICS LIBRARY 


(PICLIB) 
OBJECT 
MODULE 


LINKER 


SOURCE RUNNING 
PROGRAM COMPILER PROGRAM 


Figure E-1 


Steps in Compiling and Executing 
a FORTRAN Graphics Progran 


Step 1 in Figure E-1 is initiated by a call to the 
FORTRAN Compiler, accompanied by a command string 
that ‘describes input and output files, and switch 
options to be used by the Compiler. Step 2 is 
“{nitiated by a call to the Linker, accompanied : “by” 
a-similar_command string. Step 3 is initiated upon 
® user keyboard request or a user - programmed request. 


Step 1!: The DOS/BATCH FORTRAN compiler accepts a 
standard DOS command string of the form: 


#object module, listing < source/options 
A typical FORTRAN command string is of the form: 


#SY2:PROG1.OBJ,SY¥:2PROGI.LST < SY: PROG1.FIN/ON 
or 
#PROG1,PROG1 < PROG1/0ON 


(device SY: assumed the default device, just 
as the filename extentions .OBJ, .LST and .FIN 
are the default filename extentions when not 
specified.) 


In the above example, the user should note the use 
of the “one word integers" switch (/ON) in the 
source file specification: < PROG1/0N. 


1See Reference 3, Part 7, Chapter 9, Operating Procedures, for 
specific details. 


€ 


Step_23: The DOS/BATCH Linker accepts a standard DOS 
command string of the form: 


#load module,load map,symbol table < object modules/E 
A typical LINK command string is of the form: 


#SY2PROG1.LDA,SY: PROG1.MAP,SY2:PROG1.STB < SY: PROG1.0BJ 
#SY:PICLIB.OBJ,SY:FTNLIB.OBJ/E 

or 
#PROG1, PROG1, PROG 1<PROG1, PICLIB, FINLIB/E 


(device SY:is assumed to default device, just as the 
filename extentions .LDA, .MAP, «STB and .OBJ are the 
default filename extensions when not specified.) 


In the above example, the user should note the 
specification of THE PICTURE SYSTEM Graphics - 
Library (PICLIB) and the FORTRAN OTS Library (FINLIB). 
These libraries are seached to resolve all global 
references for the load module. These libraries 
(PICLIB) and (FINLIB) reside in the systems area 
{1,1] and are therefore available to all users. 
Note: The Linker searches the user's [UIC] area 
for all object files specified. If an object file 
is not found, the system. area [1,1] is peatcned 
regardless of the user uIC. 


Step 32: To run a load module which has been created by the 
Linker, a user need only request the monitor to 
tun the program. This is accomplished by the 
monitor commands: 


$RUN SY:PROG1.LDA 
or ) 
$RUN PROG1 


(device SY: is assumed the default davice, just as 
the filename extention .~.LDA is the default 
filename extention when not specified.) 


The following is a typical listing which illustrates 
the process described by ES gnES E-1 and steps 1, 2 and 
3 above. 


1See Reference 3, Part 9, Chapter 3, Operating Procedures, for 
Specific details. 
2See Reference 3, Part 3, Chapter 2, Monitor Keyboard Commands. 


 $L0G 162,114 
@ DATE: -31-MAY-74 
TIME: -15:25:65 
$RUN FORTRN 
FORTRAN Y66. 13 
#PROGI,. KB: CPROG1/ON 


FORTRAN V6. 13 45:35:44 Z4-MAY-74 © PAGE 4 
C FORTRAN DEMONSTRATION PROGRAM 
ga04 : DIMENSION IHOUSEC14) 
gone : DATA IHQUSE/-10000. 10000. -10000, -19000, 1000, -14000, 10000 
1 , 10000, 10000, 10000, &, 20000, 14000, 190007 
: INITIALIZE THE PICTURE SYSTEM 
aae3 ae CALL PSINITCR) B02) 
DRAM THE DATA 
9064 : CALL DRAWZD¢IHOUSE, 7, 2,2. @) 
-_ © AND“ DTSPLAY THE "NEW FRAME" 
& 9885 i CALL NUFRAM 
6086 : PALISE 
gae7 : STOF 
gaas END 


ROUTINES CALLED: 
FSINIT, DRAWeD. NUFRAM 


GFTIONS =/0N, “OF: 2 


BLOCK LENGTH 

MALIN. 6? COGAZ06)* 

*kCOMPILER ----- CORE a 
FHASE USED FREE 


DECLARATIVES @@622 14228 
EXECUTABLES @@7G@e 16146 
ASSEMBLY BA4eeo 14601 


$RUN LINK 2 


LINK V@1-@3 
#PROG1, PROGICPROGS. PICLIE, FINLIB/E 


SPACE USED @@553@. SPACE FREE @é3284 
#°C 
~RILL 


$RUN PROG 


APPENDIX F 
USE OF THE GRAPHICS SOFTWARE WITH THE 
RT~11 OPERATING SYSTEM 


USE OF THE GRAPHICS SOFTWARE PACKAGE 


The Graphics Software Package is available to the RT-11 
user as a library of catalogued object Modules which may 
be linked with the user's FORTRAN? or MACRO-112 progran 
to form graphics application programs. THE PICTURE 
SYSTEM Graphics Library (PICLIB), which contains all of 
the subroutines described in Chapter 4, is searched by 
the Linker (LINK)3 to load those subroutines called by 
the user program. The resulting program forms a load 
module (SAV format) which may be executed upon user 
demand. 


1 Reference 4, 
2Reference 5, Chapter 5. 
3Reference 5S, Chapter 6. 
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USE OF PDP-11 FORTRAN IV WITH THE PICTURE SYSTEM 


BI-11 FORTRAN conforms to the specifications for 
American National Standard FORTRAN and is also highly 
compatible with IBM 1130 FORTRAN. RT-11 FORTRAN pro- 
qcrams can be compiled and run of any PICTURE SYSTEM 
configuration that supports the RT-11 Operating 
System, and which has a minimum of 8K of memory. 
RT-11 FORTRAN supports all standard hardware options 
Supported by the operating systen. 


Graphics applications programs written using FORTRAN 
interface to THE PICTURE SYSTEM by means of the sub- 
routines contained in the Graphics Library (PICLIB). 
All FORTRAN statements and functions are available to 
the user of THE PICTURE SYSTEM: however, the following 
should be stressed to THE PICTURE SYSTEM FORTRAN user: 


All parameters passed to the subroutines 

of the Graphics Library are integers. 

Should a REAL parameter be passed as a 
parameter to a. graphics subroutine, the 

sign, binary. excess 128 exponent. and high- 
order mantissa will be treated as an integer. 


Piguve F-1. outlines the’ ‘steps. eeqai ced to prepare a4 
FORTRAN source program for execution under the 


“RE-11 Monitor: (1) Compilation, (2) Linking, and 


(3) Execution. 


FORTRAN LIBRARY 
(FORLIB) 
GRAPHICS LIBRARY 


(PIC LIB) 
OBJECT 
MODULE 


LINKER 


SOURCE RUNNING 
PROGRAM eee 


Figure F-1 


‘Steps in Compiling and Executing 
a FORTRAN Graphics Program 


Step 1 in Figure F-1 is initiated by a call to the 
FORTRAN Compiler, accompanied by a command string that 
describes input and output files, and switch options to 
be used by the Compiler. Step 2 is initiated by a call 
_to the Linker, accompanied by a Similar command string. 
tep 3 is initiated upon user keyboard request ora > 
user programmed request. 


Step 13: The RT-11 FORTRAN compiler accepts a 
command string of the forms: 


*object module, listing = source/options 


A typical FORTRAN command string is of the 
form: 


*SY: PROG 1. 0BJ,SY:PROG1.LST=SY:PROG 1. FOR 
or 
*PROG1,PROG1=PROG1 


(device SY: is assumed the default device, 
just as the filename extensions .0OBJ, .LST 
and .FOR are the default filename extensions 
when not specified.) 


1See Reference 4, Chapter 1 for specific details. 


Step 21: The RT-11 Linker accepts a command string of 


the form: 
*load nodule,load map=object modules/switches € 
A typical LINK command string is of the forms: 


*SY:3PROG1.SAV,SY3 PROG1.MAP=SY:PROG1.0BJ,SY ;PICLIB.OBJ/F 
or 
*PROG1, PROG1, PROG1=PROG1, PICLIB/F 


(device SY: is assumed to be the default device, 
just as the filename extensions .SAV, .MAP and 
-OBJ are the default filename extensions when not 
specified.) 


In the above example, the user should note the 
explicit specification of THE PICTURE SYSTEMS 
Graphics Library (PICLIB) and the FORTRAN 

OTS Library (FORLIB) by.the /F switch. These 
libraries are searched to resolve all global 
references for ta load nodule. 


Step 32: To run a ‘Voad: sodule which has been created 
by the Linker, a user need only request the. 
monitor to run the program. This is seconpls shi 
ed -by the ‘monitor command: ----— — — oe 


2RUN SY:PROG1.SAV — 
or. 
2RUN PROG1 


(device SY: is assumed the default device, 
just as the filename extension .SAV is the 
default filename extension when not specified). 


The following is a typical listing which illustrates 
the process described by pagers F-1 and steps 1, 2 
and 3 above. 


1See Reference 5, Chapter 6 for specific details. 
2See Reference 5, Chapter 2 for specific details. 


RT-44 Vai-151 
DATE #5-Nov-?4 
J RUN FORTRAN 
*PROGI, TT: =PROG4 
RT-11 FORTRAN I¥ = °— V@d-d40 SOURCE LISTING | PAGE ai 
C FORTRAN DEMONSTRATION PROGRAM 
: 


DIMENSION THOUSE Cia: 


cat 
hen] 
(a 
= 


c 


1s 
Dan} 
ma 
Po 


DATA IHQUSE/-18008. 19080, -1a00 
, 18004, 1080, 14088, o. 2 1 


INITIALIZE THE PICTURE SYSTEM 


cao ms 


AGas CALL FSINITCE, G02) 


GRAW THE DATA 


aan 


good. CALL DRAW2DCIHOUSE, 7,2, 2,8) 
i ge : 

C AND DISPLAY THE "NEW FRAME" 
p , 

gao5 sO ARLE CSNIFRAM fess “Sek 
c : 

pane FRUSE 

gaa? STOP 

Hogs END 

RY-14 FORTRAN I¥ STORAGE MAF 

HAME OFFSET ATTRIEUTES: 


THOUSE g6Gn8¢ 


& INTEGER*2 ARRAY (143 
PSINIT G8000a REALS4 | PROCEDURE 
CRANZD G8GG0G REAL#4 = PROCEDURE 

HGOG PROCEDURE 


HUPRAM aaah INTEGERS 
* 


F-5 


= 


RUN LENE. 
+PROG1s PROGI=PROGA, FICLIEVF 


*7C 


. RUN PECGL 


